summaryrefslogtreecommitdiff
path: root/gcc/ada/krunch.ads
diff options
context:
space:
mode:
authorkenner <kenner@138bc75d-0d04-0410-961f-82ee72b054a4>2001-10-02 14:18:40 +0000
committerkenner <kenner@138bc75d-0d04-0410-961f-82ee72b054a4>2001-10-02 14:18:40 +0000
commit83cce46b47d48de4c71b02a20f5bf36296a48568 (patch)
tree6570bc15069492ca4f53a85c5d09a36d099fd63f /gcc/ada/krunch.ads
parentee6ba406bdc83a0b016ec0099d84035d7fd26fd7 (diff)
downloadgcc-83cce46b47d48de4c71b02a20f5bf36296a48568.tar.gz
New Language: Ada
git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@45955 138bc75d-0d04-0410-961f-82ee72b054a4
Diffstat (limited to 'gcc/ada/krunch.ads')
-rw-r--r--gcc/ada/krunch.ads134
1 files changed, 134 insertions, 0 deletions
diff --git a/gcc/ada/krunch.ads b/gcc/ada/krunch.ads
new file mode 100644
index 00000000000..54877bce5a7
--- /dev/null
+++ b/gcc/ada/krunch.ads
@@ -0,0 +1,134 @@
+------------------------------------------------------------------------------
+-- --
+-- GNAT COMPILER COMPONENTS --
+-- --
+-- K R U N C H --
+-- --
+-- S p e c --
+-- --
+-- $Revision: 1.13 $ --
+-- --
+-- Copyright (C) 1992-1997 Free Software Foundation, Inc. --
+-- --
+-- GNAT is free software; you can redistribute it and/or modify it under --
+-- terms of the GNU General Public License as published by the Free Soft- --
+-- ware Foundation; either version 2, or (at your option) any later ver- --
+-- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
+-- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
+-- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
+-- for more details. You should have received a copy of the GNU General --
+-- Public License distributed with GNAT; see file COPYING. If not, write --
+-- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, --
+-- MA 02111-1307, USA. --
+-- --
+-- As a special exception, if other files instantiate generics from this --
+-- unit, or you link this unit with other files to produce an executable, --
+-- this unit does not by itself cause the resulting executable to be --
+-- covered by the GNU General Public License. This exception does not --
+-- however invalidate any other reasons why the executable file might be --
+-- covered by the GNU Public License. --
+-- --
+-- GNAT was originally developed by the GNAT team at New York University. --
+-- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). --
+-- --
+------------------------------------------------------------------------------
+
+-- This procedure implements file name crunching
+
+-- First, the name is divided into segments separated by minus signs and
+-- underscores, then all minus signs and underscores are eliminated. If
+-- this leaves the name short enough, we are done.
+
+-- If not, then the longest segment is located (left-most if there are
+-- two of equal length), and shortened by dropping its last character.
+-- This is repeated until the name is short enough.
+
+-- As an example, consider the krunch of our-strings-wide_fixed.adb
+-- to fit the name into 8 characters as required by DOS:
+
+-- our-strings-wide_fixed 22
+-- our strings wide fixed 19
+-- our string wide fixed 18
+-- our strin wide fixed 17
+-- our stri wide fixed 16
+-- our stri wide fixe 15
+-- our str wide fixe 14
+-- our str wid fixe 13
+-- our str wid fix 12
+-- ou str wid fix 11
+-- ou st wid fix 10
+-- ou st wi fix 9
+-- ou st wi fi 8
+
+-- Final file name: OUSTWIFX.ADB
+
+-- A special rule applies for children of System, Ada, Gnat, and Interfaces.
+-- In these cases, the following special prefix replacements occur:
+
+-- ada- replaced by a-
+-- gnat- replaced by g-
+-- interfaces- replaced by i-
+-- system- replaced by s-
+
+-- The rest of the name is krunched in the usual manner described above.
+-- In addition, these names, as well as the names of the renamed packages
+-- from the obsolescent features annex, are always krunched to 8 characters
+-- regardless of the setting of Maxlen.
+
+-- As an example of this special rule, consider ada-strings-wide_fixed.adb
+-- which gets krunched as follows:
+
+-- ada-strings-wide_fixed 22
+-- a- strings wide fixed 18
+-- a- string wide fixed 17
+-- a- strin wide fixed 16
+-- a- stri wide fixed 15
+-- a- stri wide fixe 14
+-- a- str wide fixe 13
+-- a- str wid fixe 12
+-- a- str wid fix 11
+-- a- st wid fix 10
+-- a- st wi fix 9
+-- a- st wi fi 8
+
+-- Final file name: A-STWIFX.ADB
+
+-- Since children of units named A, G, I or S might conflict with the names
+-- of predefined units, the naming rule in that case is that the first hyphen
+-- is replaced by a tilde sign.
+
+-- Note: as described below, this special treatment of predefined library
+-- unit file names can be inhibited by setting the No_Predef flag.
+
+-- Of course there is no guarantee that this algorithm results in uniquely
+-- crunched names (nor, obviously, is there any algorithm which would do so)
+-- In fact we run into such a case in the standard library routines with
+-- children of Wide_Text_IO, so a special rule is applied to deal with this
+-- clash, namely the prefix ada-wide_text_io- is replaced by a-wt- and then
+-- the normal crunching rules are applied, so that for example, the unit:
+
+-- Ada.Wide_Text_IO.Float_IO
+
+-- has the file name
+
+-- a-wtflio
+
+-- This is the only irregularity required (so far!) to keep the file names
+-- unique in the standard predefined libraries.
+
+procedure Krunch
+ (Buffer : in out String;
+ Len : in out Natural;
+ Maxlen : Natural;
+ No_Predef : Boolean);
+pragma Elaborate_Body (Krunch);
+-- The full file name is stored in Buffer (1 .. Len) on entry. The file
+-- name is crunched in place and on return Len is updated, so that the
+-- resulting krunched name is in Buffer (1 .. Len) where Len <= Maxlen.
+-- Note that Len may be less than or equal to Maxlen on entry, in which
+-- case it may be possible that Krunch does not modify Buffer. The fourth
+-- parameter, No_Predef, is a switch which, if set to True, disables the
+-- normal special treatment of predefined library unit file names.
+--
+-- Note: the string Buffer must have a lower bound of 1, and may not
+-- contain any blanks (in particular, it must not have leading blanks).