[patch #6103] Improve data file format documentation

[Ben Pfaff]

URL:
  <http://savannah.gnu.org/patch/?6103>

                 Summary: Improve data file format documentation
                 Project: PSPP
            Submitted by: blp
            Submitted on: Tuesday 07/17/2007 at 12:14
                Category: None
              Item Group: None
                  Status: Ready For Test/Review
             Assigned to: jmd
        Originator Email: 
             Open/Closed: Open
         Discussion Lock: Any

    _______________________________________________________

Details:

This change makes the following improvements:

* Explain how very long strings are stored in a data file.

* Correct descriptions of data types and describe how PSPP actually detects
integer and floating-point formats.

* Make it easier to understand the record ordering.

* Don't try so hard to make the format descriptions look like C structs.

* Define "dictionary index".

* Reformat list of format types to make it easier to read.

* Combine value labels record, value labels variable record into a single
section, for clarity.

* Rename "auxiliary variable parameter record" to "variable display parameter
record", which is more descriptive.

* General proofreading.

I have a followup change that improves the sys-file-reader and
sys-file-writer code.  It's not quite ready yet.



    _______________________________________________________

File Attachments:


-------------------------------------------------------
Date: Tuesday 07/17/2007 at 12:14  Name: dff.patch  Size: 36kB   By: blp

<http://savannah.gnu.org/patch/download.php?file_id=13375>

    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/patch/?6103>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/