From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,98b61370aa4ee86e,start X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 2003-06-27 06:10:34 PST Path: archiver1.google.com!news1.google.com!newsfeed.stanford.edu!logbridge.uoregon.edu!hammer.uoregon.edu!skates!not-for-mail From: Stephen Leake Newsgroups: comp.lang.ada Subject: Grace.Config_Files comment preserving details Date: 27 Jun 2003 09:03:19 -0400 Organization: NASA Goddard Space Flight Center (skates.gsfc.nasa.gov) Message-ID: NNTP-Posting-Host: anarres.gsfc.nasa.gov Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: skates.gsfc.nasa.gov 1056719028 13757 128.183.235.92 (27 Jun 2003 13:03:48 GMT) X-Complaints-To: usenet@news.gsfc.nasa.gov NNTP-Posting-Date: 27 Jun 2003 13:03:48 GMT User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3 Xref: archiver1.google.com comp.lang.ada:39808 Date: 2003-06-27T13:03:48+00:00 List-Id: (See http://java.sun.com/j2se/1.4.1/docs/api/java/util/Properties.html, "load" method, and http://www.nongnu.org/Grace/config_files.html) The Java Properties definition doesn't say anything about preserving comments when writing the file. The current Config_Files requirement says comments are preserved, but isn't detailed enough to say how it works. David Koogler proposed some details, and I've added more, to get the following proposed requirement: Comments are associated with a key, and are preserved thru open and flush. Comments are intended to guide manually editing the file. Consecutive whole line comments appearing before a key are associated with that key, and are written to the file in the same form as they were read in. Whole line comments separated by blank lines from any following key do not associate and are lost during writing. (David also wants comments on the same line as a key/value pair, but I've deleted that here). Discussion? -- -- Stephe