Add README.md

Final version.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Merge branch 'HEAD' of dwarfgit@dwarfstd.org:dwarf-doc.git

Final version...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Minor tweeks to the Turkish hash folding exception.

Final Review Draft...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Backup of today's work. Still awaiting a couple more editorial inputs.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Incorporate 161122.1, the fixed sized variants of DW_FORM_strx.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Merge branch 'HEAD' of dwarfgit@dwarfstd.org:dwarf-doc.git

Save changes made for results of the Jan 3, 2017 meeting.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Small formatting fix.

Speeling tweak, plus change year to 2017.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Cleanup loose-ends from previous submission (Dec 18).

Signed-off-by: Ron Brender <ron.brender@gmail.com>

compression.tex
Fixes issue 160602.1 per Dec 6 meeting minutes
     // Step 4: 'A' \DWATname \DWFORMstring "y"
-    0x41 0x03 0x08 0x78 0x00
+    0x41 0x03 0x08 0x79 0x00
     // Step 4: 'A' \DWATdatamemberlocation \DWFORMsdata 4

Merge then checkpoint work to date...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Merge branch 'HEAD' of dwarfgit@dwarfstd.org:dwarf-doc.git

Checkpoint work to date...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Remove mistakenly checked in file.

Had invalid spaces in command. Changed to a leading tab
latexdoc/Makefile

Tweak "PRE-APPROVED to read "PRE-RELEASE" to avoid ambiguity.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Version for committee consideration at complete\ion of public review.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Merge branch 'HEAD' of dwarfgit@dwarfstd.org:dwarf-doc.git

Conflicts:
dwarf5/latexdoc/sectionversionnumbers.tex
 Merged and re-submitted...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Checkpoint current state--not for general distribution.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

.debug_line_str section doesn't have a version number, so replace
5 with *.

Add missing accent on my surname.

Fix make clean.

This is the Public Review Draft.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Pre-Public Review Draft.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Check point progress to date...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Check point of work to date.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Include editorial changes from Coutant in Chapter 6 and 7
(accidently omitted from previous submission).
Signed-off-by: Ron Brender <ron.brender@gmail.com>

Added -rm -f *.cb to clean: section per David Anderson.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Remove prior change bars. Add changes from the 6/21/2015 Committee
meeting plus edorial inputs from Anderson and Walker. This checkpoint
is not intended for a PDF distribution.
Signed-off-by: Ron Brender <ron.brender@gmail.com>

Incorporate changes as of the May 17 meeting. The corresponding
.pdf is being distributed...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Save current state before a LaTeX/.git software update...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

This submission corresponds to the March 7, 2016 version released
to the full DWARF committee. Used to create dwarf5.20160307.pdf.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Check point of current work in progress...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Save checkpoint of changes since Jan 28, 2016 group
editorial review. More are expected so this is not
for distribution as a group review document.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Backup of editorial work to date. Not intended to be
distributed as a .pdf to the committee.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Review copy for general distribution to Committee. Includes changes
from Oct 7-8, 2015. Includes line numbers.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Backup of working files incorporating changes from editorial review
meetings of Oct 7-8, 2015. Not intended as a general release at this
time.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

A few more tweaks to go with the previous...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Working checkpoint for editoial changes resulting from the
Aug 25-26, 2015 review meetings. Try out the line numbering
feature (package lineno).

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Fix hot link problem found on page 400.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

This corresponds to the August 11, 2015 distribution...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Checkpoint following major upgrade of the Name index figure (Fig 6.1)
contributed by Cary Coutant.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Working copy for backup...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Draft document for Committee review.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Merge branch 'HEAD' of dwarfgit@dwarfstd.org:dwarf-doc.git

Prepare for merge...

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Replace all [here] positioning arguments with the more compatible [h].

Redraw figure 6.1 Accelerated Name Access Diagram in TikZ.

Save current working version in preparation for some largish changes.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Working document update--not distributed to Committee/

Signed-off-by: Ron Brender <ron.brender@gmail.com>

This version *almost* corresponds to the dwarf5.20150613.pdf
distributed for committee review. Unfortunately I forgot to
capture the files used for creating that version. These files
are one day newer. All changes from the distributed version
are minor and purely editorial.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Update/backup current working version. Not for general committee release.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Latest document in preparation for May 19, 2015 meeting.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Update Appendix B based on input from Dave Anderson.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Save changes due to committe review... Big changes are due to
comments from Eager plus moving some DWARF stack related examples
into Appendix D.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

More changes from Committee review. This checkin corresponds to
dwarf5.20150426.pdf.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Working update reflecting many changes based on full
Committee review comments. This is not for a document
version that will be distributed--many comments remain.
But the comments have been thorough and the changes
many so this seems like generally a good idea.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Bring up to date with the February 2015 meeting and the
review version distributed on March 4, 2015.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Bring up to date with December 16, 2014 meeting and
all review comments as of this date.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Add split objects example in App F.2 and correct misc other
editorial matters.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Bring up to date with October 21 DWARF meeting and other review
feedback.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Bring document up to date with September 2014 meeting.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Complete processing of review comments to date and do index improvements.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Cleanup two hyperlink problems.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Changes from review comments and July 15 meeting, except changes
for line number headers (140323.1 and 140331.2).

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Posted a review document this date. Includes all issues and
review comments to date.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Merge branch 'HEAD' of dwarfgit@dwarfstd.org:dwarf-doc.git

Miscellaneous tweaks and repairs

Signed-off-by: Ron Brender <ron.brender@gmail.com>

tools/refer.py

There are various special cases of newcommand that we were
ignoring, thus ignoring bad hyperlinks.

Now, one thinks, we find them all.

tools/fileio.py was not tokenizing
    \a\b
into two id entries as it should have.
Fixed.

tools:
fileio.py has new functions for referb.py
refer.py  modified so it works on current tex

referb.py New. Similar to refer.py but each file made
    into a single token list which is more general.
    Not yet working, but so far refer.py suffices.

Up to date with all available input, including issues approved
at May 2014 meeting.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Bring up to date with approved issues as of April 2014.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Complete revisions to Appendix B regarding new
.debug_macro representation.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Incorporate changes through March 2014, except for
100909.2 (DW_CALL_call_site) and parts of Appendix B.

refer.py changes:
1) use io.path.join to make OS independent
2) fix handling of DW*MARK names (to act like targets)
3) tweak output to make easier to use

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Changes for 130526.1 (type unit mere)
Signed-off-by: Ron Brender <ron.brender@gmail.com>

Merge branch 'HEAD' of dwarfgit@dwarfstd.org:dwarf-doc.git

Signed-off-by: Ron Brender <ron.brender@gmail.com>

tools/README: Documented refer.py and repeats.py

Fixing two 1-line typos.
latexdoc/generaldescription.tex

This was mentioned on the list a week or two ago.
Fix eliminates a duplicated word pair from the document.
-\addtoindex{mangled names}
-mangled names.
+\addtoindex{mangled names}.

Noticed this when looking at the index entries for mangled
names (we do not want the ! to appear in the body of text).
-\addtoindex{names!mangled}
+\addtoindexx{names!mangled}

tools/README: Added another quick check that finds
 typos in indexing.

tools/README: Finishing up the repeats commentary.

Adding a new command to look for accidental
word repeats.

tools/README: Document use of repeats.py
tools/repeats.py: Looks for repeated words or phrases
tools/testrepeats.txt: Small test case for repeats.py

To get refer.py to work at all these 3 .tex changes
were helpful.

latexdoc/attributesbytag.tex:
The livetarg command has two arguments.

-\livetarg{chap:DECL}
+\livetarg{chap:DECL}{}

latexdoc/generaldescription.tex:
The original split a livelinki over two lines.
Bad for the (rather weak) refer.py parser code.

-&\livelinki{chap:DWATartificialobjectsortypesthat}{Objects or types that are not
-actually declared in the source}{objects or types that are not actually declared i
n the source}  \\
+&\livelinki{chap:DWATartificialobjectsortypesthat}{Objects or types that are not a ctually declared in the source}{objects or types that are not actually declared in the source}  \\

latexdoc/programscope.tex:
The hypertarget command has two arguments.

-\hypertarget{chap:DWATrecursiverecursivepropertyofasubroutine}
+\hypertarget{chap:DWATrecursiverecursivepropertyofasubroutine}{}

tools/refer.py: Now seems to work finding problems.
tools/testrefer.tex: Tweaked the testcase a little.

refer.py: New app, close to working. To identify
  bad links/references.

fileio.py: Minor fix so [ and ] can be parsed properly,
 and so \ not allowed in middle ofnames so \DWa\DWb
 parsed as two names.

testrefer.tex: A small test file for refer.py

examples.tex

-\caption{Fortran multidimentional coarray: source fragment}
+\caption{Fortran multidimensional coarray: source fragment}

datarepresentation.tex

-  \hline \bfseries Visiibility code name&\bfseries Value \\ \hline
+  \hline \bfseries Visibility code name&\bfseries Value \\ \hline

programscope.tex
-\addtoindexx{trampoline (subprogam) entry}
+\addtoindexx{trampoline (subprogram) entry}

Another typo illuminated by the spell
checker.

README:  Added example shell code using pdftotext and spell
to do spelling check.

debugsectionrelationships.tex:
-\DWFORMaddrx, \DWOPaddrx and \DWOPconstx{} contain
+\DWFORMaddrx, \DWOPaddrx{} and \DWOPconstx{} contain

So that the DWOPaddrx does not become 'DW_OP_addrxand'
in the output.

generaldescription.tex  fix spelling: perfom -> perform

otherdebugginginformation.tex: spelling correction.
Changed preceeding to preceding

tools/README: Documented what each .py file does.
tools/refclassfixup.py: Added a comment documenting
   what this code does (it lacked any hint).

Incorporte all changes and approved issued to date.

Signed-off-by: Ron Brender <ron.brender@gmail.com>

Files for 2013-12-18 draft document. This incorporates
all approved changes and review comments to date.

Signed-off-by: Ron Brender <ron.brender@gmail.com>