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>

Update for the November 22, 2013 version of the document.
Included are all approved issues and review comments up to
that date.

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

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

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

Fixup several missing DWnameTARG issues.

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

Completed integration and use of new name commands (with generous
help from David Anderson).

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

Two additional typos in dwarfnamecmds.tex fixed.

Found a bug in the python dellivelink.py and fixed it. Added a bit to the
testcase in tools to expose the bug.

Found 6 small and obvious typos/omissions in dwarfnames.tex.
Fixed.

When a label has a digit in it dellivelink.py notices
and prints a warning. And for that instance, does not convert
to the new form.
Because digits are not allowed in command names.
The remaining instances should be fixed in the .tex.

Some obvious small fixes to dwarfnamecmds.tex are needed for
things to work. These typos lead to the pdf build getting
an error. We cannot be sure all the typos fixed till we
try removing all the livelink livetarg using dellivelink.py
on all the .tex.

Seemingly dellivelink.py works properly now, though
generating the document with its changes is failing.
So the latex document has none of dellivelink.py changes
applied.

Two lines in dwarfnamecmds.tex had typos. Fixed.

Now tools/dellivelink.py deals with altt
sensibly.

Removed the debug print statements from
 dellivelink.py

This python dellivelink.py removes \livelink and \livetarg
in favor of the new format like \DWOPplus  and so on.
dellivelink.tex is a file used to test the code.

Filled out dwarfnamecmds.tex with the full set of Dwarf name symbols.
Made changes in other files to match a few special cases (eg, for
DW_OP_lit2, _lit11, and the like that do not deserve "full treatment".

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

Introduce \newdwfnamecommands command that defines multiple
commands based corresponding to DWARF symbolic names. Make
the most common case, eg, \DWATname, be the form that results
in both an index entry and a live link (that is, reverse the
LL suffix convention introduced in the previous submision.

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

Editorial cleanups mostly related to coarrays and assumed rank arrays.

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

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

Prepare for merge...

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

Incorporate Issue 130313.5, Add support for Fortran assumed-rank arrays.

Added a make check target to list missing references.

First draft of Version 5, incorporating numerous approved changes
(see new Change Summary in Draft versions).

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

dwarf5.tex : Minor change removes an hbox overfull
warning from latex (though lots of them remain).

dataobject.tex: An internal link was misspelled:  chap:class:reference->chap:classreference      latex caught it.

Ron Brender reviewed these changes.

A few miscelleaneous corrections including especially fixing the spacing
around lists using /tight, which is specific to the memoire class (setting
/topsep to zero has no effect).

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