OpenCores
URL https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [gnu-src/] [gcc-4.5.1/] [gcc/] [ada/] [krunch.ads] - Blame information for rev 281

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 281 jeremybenn
------------------------------------------------------------------------------
2
--                                                                          --
3
--                         GNAT COMPILER COMPONENTS                         --
4
--                                                                          --
5
--                               K R U N C H                                --
6
--                                                                          --
7
--                                 S p e c                                  --
8
--                                                                          --
9
--          Copyright (C) 1992-2009, Free Software Foundation, Inc.         --
10
--                                                                          --
11
-- GNAT is free software;  you can  redistribute it  and/or modify it under --
12
-- terms of the  GNU General Public License as published  by the Free Soft- --
13
-- ware  Foundation;  either version 3,  or (at your option) any later ver- --
14
-- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
15
-- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
16
-- or FITNESS FOR A PARTICULAR PURPOSE.                                     --
17
--                                                                          --
18
-- As a special exception under Section 7 of GPL version 3, you are granted --
19
-- additional permissions described in the GCC Runtime Library Exception,   --
20
-- version 3.1, as published by the Free Software Foundation.               --
21
--                                                                          --
22
-- You should have received a copy of the GNU General Public License and    --
23
-- a copy of the GCC Runtime Library Exception along with this program;     --
24
-- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
25
-- <http://www.gnu.org/licenses/>.                                          --
26
--                                                                          --
27
-- GNAT was originally developed  by the GNAT team at  New York University. --
28
-- Extensive contributions were provided by Ada Core Technologies Inc.      --
29
--                                                                          --
30
------------------------------------------------------------------------------
31
 
32
--  This procedure implements file name crunching
33
 
34
--    First, the name is divided into segments separated by minus signs and
35
--    underscores, then all minus signs and underscores are eliminated. If
36
--    this leaves the name short enough, we are done.
37
 
38
--    If not, then the longest segment is located (left-most if there are
39
--    two of equal length), and shortened by dropping its last character.
40
--    This is repeated until the name is short enough.
41
 
42
--    As an example, consider the krunch of our-strings-wide_fixed.adb
43
--    to fit the name into 8 characters as required by DOS:
44
 
45
--      our-strings-wide_fixed      22
46
--      our strings wide fixed      19
47
--      our string  wide fixed      18
48
--      our strin   wide fixed      17
49
--      our stri    wide fixed      16
50
--      our stri    wide fixe       15
51
--      our str     wide fixe       14
52
--      our str     wid  fixe       13
53
--      our str     wid  fix        12
54
--      ou  str     wid  fix        11
55
--      ou  st      wid  fix        10
56
--      ou  st      wi   fix         9
57
--      ou  st      wi   fi          8
58
 
59
--      Final file name: OUSTWIFX.ADB
60
 
61
--    A special rule applies for children of System, Ada, Gnat, and Interfaces.
62
--    In these cases, the following special prefix replacements occur:
63
 
64
--       ada-        replaced by  a-
65
--       gnat-       replaced by  g-
66
--       interfaces- replaced by  i-
67
--       system-     replaced by  s-
68
 
69
--    The rest of the name is krunched in the usual manner described above.
70
--    In addition, these names, as well as the names of the renamed packages
71
--    from the obsolescent features annex, are always krunched to 8 characters
72
--    regardless of the setting of Maxlen.
73
 
74
--    As an example of this special rule, consider ada-strings-wide_fixed.adb
75
--    which gets krunched as follows:
76
 
77
--      ada-strings-wide_fixed      22
78
--      a-  strings wide fixed      18
79
--      a-  string  wide fixed      17
80
--      a-  strin   wide fixed      16
81
--      a-  stri    wide fixed      15
82
--      a-  stri    wide fixe       14
83
--      a-  str     wide fixe       13
84
--      a-  str     wid  fixe       12
85
--      a-  str     wid  fix        11
86
--      a-  st      wid  fix        10
87
--      a-  st      wi   fix         9
88
--      a-  st      wi   fi          8
89
 
90
--      Final file name: A-STWIFX.ADB
91
 
92
--  Since children of units named A, G, I or S might conflict with the names
93
--  of predefined units, the naming rule in that case is that the first hyphen
94
--  is replaced by a tilde sign.
95
 
96
--  Note: as described below, this special treatment of predefined library
97
--  unit file names can be inhibited by setting the No_Predef flag.
98
 
99
--  Of course there is no guarantee that this algorithm results in uniquely
100
--  crunched names (nor, obviously, is there any algorithm which would do so)
101
--  In fact we run into such a case in the standard library routines with
102
--  children of Wide_Text_IO, so a special rule is applied to deal with this
103
--  clash, namely the prefix ada-wide_text_io- is replaced by a-wt- and then
104
--  the normal crunching rules are applied, so that for example, the unit:
105
 
106
--    Ada.Wide_Text_IO.Float_IO
107
 
108
--  has the file name
109
 
110
--    a-wtflio
111
 
112
--  More problems arise with Wide_Wide, so we replace this sequence by
113
--  a z (which is not used much) and also (as in the Wide_Text_IO case),
114
--  we replace the prefix ada.wide_wide_text_io- by a-zt- and then
115
--  the normal crunching rules are applied.
116
 
117
--  These are the only irregularity required (so far!) to keep the file names
118
--  unique in the standard predefined libraries.
119
 
120
procedure Krunch
121
  (Buffer        : in out String;
122
   Len           : in out Natural;
123
   Maxlen        : Natural;
124
   No_Predef     : Boolean;
125
   VMS_On_Target : Boolean := False);
126
pragma Elaborate_Body (Krunch);
127
--  The full file name is stored in Buffer (1 .. Len) on entry. The file
128
--  name is crunched in place and on return Len is updated, so that the
129
--  resulting krunched name is in Buffer (1 .. Len) where Len <= Maxlen.
130
--  Note that Len may be less than or equal to Maxlen on entry, in which
131
--  case it may be possible that Krunch does not modify Buffer. The fourth
132
--  parameter, No_Predef, is a switch which, if set to True, disables the
133
--  normal special treatment of predefined library unit file names.
134
--  VMS_On_Target, when True, indicates to Krunch to apply the VMS treatment
135
--  to the children of package A, G,I or S.
136
--
137
--  Note: the string Buffer must have a lower bound of 1, and may not
138
--  contain any blanks (in particular, it must not have leading blanks).

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.