Ron Brender [Tue, 13 May 2014 17:44:14 +0000 (13:44 -0400)]
Bring up to date with approved issues as of April 2014.
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Sat, 19 Apr 2014 16:30:51 +0000 (12:30 -0400)]
Complete revisions to Appendix B regarding new
.debug_macro representation.
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Thu, 17 Apr 2014 19:55:02 +0000 (15:55 -0400)]
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>
Ron Brender [Mon, 14 Apr 2014 19:14:02 +0000 (15:14 -0400)]
Changes for 130526.1 (type unit mere)
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Mon, 14 Apr 2014 16:41:07 +0000 (12:41 -0400)]
Merge branch 'HEAD' of dwarfgit@dwarfstd.org:dwarf-doc.git
Ron Brender [Mon, 14 Apr 2014 16:40:56 +0000 (12:40 -0400)]
Signed-off-by: Ron Brender <ron.brender@gmail.com>
David Anderson [Thu, 27 Feb 2014 21:03:12 +0000 (13:03 -0800)]
tools/README: Documented refer.py and repeats.py
David Anderson [Sun, 23 Feb 2014 17:33:28 +0000 (09:33 -0800)]
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}
David Anderson [Sun, 23 Feb 2014 17:31:32 +0000 (09:31 -0800)]
tools/README: Added another quick check that finds
typos in indexing.
David Anderson [Sun, 23 Feb 2014 17:23:41 +0000 (09:23 -0800)]
tools/README: Finishing up the repeats commentary.
David Anderson [Sun, 23 Feb 2014 17:15:23 +0000 (09:15 -0800)]
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
David Anderson [Sat, 22 Feb 2014 17:18:36 +0000 (09:18 -0800)]
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}{}
David Anderson [Sat, 22 Feb 2014 17:12:29 +0000 (09:12 -0800)]
tools/refer.py: Now seems to work finding problems.
tools/testrefer.tex: Tweaked the testcase a little.
David Anderson [Fri, 21 Feb 2014 23:18:15 +0000 (15:18 -0800)]
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
David Anderson [Thu, 20 Feb 2014 22:46:31 +0000 (14:46 -0800)]
examples.tex
-\caption{Fortran multidimentional coarray: source fragment}
+\caption{Fortran multidimensional coarray: source fragment}
David Anderson [Thu, 20 Feb 2014 22:41:59 +0000 (14:41 -0800)]
datarepresentation.tex
- \hline \bfseries Visiibility code name&\bfseries Value \\ \hline
+ \hline \bfseries Visibility code name&\bfseries Value \\ \hline
David Anderson [Thu, 20 Feb 2014 22:38:41 +0000 (14:38 -0800)]
programscope.tex
-\addtoindexx{trampoline (subprogam) entry}
+\addtoindexx{trampoline (subprogram) entry}
Another typo illuminated by the spell
checker.
David Anderson [Thu, 20 Feb 2014 21:21:06 +0000 (13:21 -0800)]
README: Added example shell code using pdftotext and spell
to do spelling check.
David Anderson [Thu, 20 Feb 2014 21:12:48 +0000 (13:12 -0800)]
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.
David Anderson [Thu, 20 Feb 2014 20:39:53 +0000 (12:39 -0800)]
generaldescription.tex fix spelling: perfom -> perform
David Anderson [Thu, 20 Feb 2014 18:18:49 +0000 (10:18 -0800)]
otherdebugginginformation.tex: spelling correction.
Changed preceeding to preceding
David Anderson [Wed, 19 Feb 2014 19:34:00 +0000 (11:34 -0800)]
tools/README: Documented what each .py file does.
tools/refclassfixup.py: Added a comment documenting
what this code does (it lacked any hint).
Ron Brender [Sat, 8 Feb 2014 22:47:03 +0000 (17:47 -0500)]
Incorporte all changes and approved issued to date.
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Thu, 19 Dec 2013 00:06:53 +0000 (19:06 -0500)]
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>
Ron Brender [Sat, 23 Nov 2013 20:12:23 +0000 (15:12 -0500)]
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>
Ron Brender [Tue, 29 Oct 2013 11:16:21 +0000 (07:16 -0400)]
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Tue, 29 Oct 2013 11:15:11 +0000 (07:15 -0400)]
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Fri, 11 Oct 2013 10:47:05 +0000 (06:47 -0400)]
Fixup several missing DWnameTARG issues.
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Thu, 10 Oct 2013 19:15:50 +0000 (15:15 -0400)]
Completed integration and use of new name commands (with generous
help from David Anderson).
Signed-off-by: Ron Brender <ron.brender@gmail.com>
David Anderson [Tue, 8 Oct 2013 16:26:47 +0000 (09:26 -0700)]
Two additional typos in dwarfnamecmds.tex fixed.
David Anderson [Tue, 8 Oct 2013 15:57:15 +0000 (08:57 -0700)]
Found a bug in the python dellivelink.py and fixed it. Added a bit to the
testcase in tools to expose the bug.
David Anderson [Tue, 8 Oct 2013 15:56:34 +0000 (08:56 -0700)]
Found 6 small and obvious typos/omissions in dwarfnames.tex.
Fixed.
David Anderson [Tue, 8 Oct 2013 15:21:32 +0000 (08:21 -0700)]
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.
David Anderson [Tue, 8 Oct 2013 15:19:35 +0000 (08:19 -0700)]
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.
David Anderson [Sun, 6 Oct 2013 16:34:59 +0000 (09:34 -0700)]
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.
David Anderson [Sun, 6 Oct 2013 16:34:24 +0000 (09:34 -0700)]
Two lines in dwarfnamecmds.tex had typos. Fixed.
David Anderson [Sun, 6 Oct 2013 15:59:14 +0000 (08:59 -0700)]
Now tools/dellivelink.py deals with altt
sensibly.
David Anderson [Sat, 5 Oct 2013 21:51:50 +0000 (14:51 -0700)]
Removed the debug print statements from
dellivelink.py
David Anderson [Sat, 5 Oct 2013 21:43:10 +0000 (14:43 -0700)]
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.
Ron Brender [Fri, 4 Oct 2013 14:52:21 +0000 (10:52 -0400)]
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>
Ron Brender [Mon, 30 Sep 2013 16:26:45 +0000 (12:26 -0400)]
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>
Ron Brender [Fri, 27 Sep 2013 19:19:04 +0000 (15:19 -0400)]
Editorial cleanups mostly related to coarrays and assumed rank arrays.
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Thu, 26 Sep 2013 19:49:08 +0000 (15:49 -0400)]
Merge branch 'master' of dwarfgit@dwarfstd.org:dwarf-doc.git
Ron Brender [Thu, 26 Sep 2013 19:48:25 +0000 (15:48 -0400)]
Prepare for merge...
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Adrian Prantl [Mon, 23 Sep 2013 23:17:49 +0000 (16:17 -0700)]
Incorporate Issue 130313.5, Add support for Fortran assumed-rank arrays.
Adrian Prantl [Mon, 23 Sep 2013 23:15:21 +0000 (16:15 -0700)]
Added a make check target to list missing references.
Ron Brender [Sat, 22 Jun 2013 21:21:14 +0000 (17:21 -0400)]
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>
David Anderson [Tue, 28 May 2013 23:55:56 +0000 (16:55 -0700)]
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.
Ron Brender [Sun, 19 May 2013 01:23:59 +0000 (21:23 -0400)]
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>
Ron Brender [Fri, 10 May 2013 20:59:24 +0000 (16:59 -0400)]
Complete work on live links, cleanup some indexing and redo pagination.
This completes all review processing.
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Thu, 9 May 2013 18:02:17 +0000 (14:02 -0400)]
This completes (many!) changes resulting from reviews over the
last several months.
Signed-off-by: Ron Brender <ron.brender@gmail.com>
David Anderson [Sat, 4 May 2013 01:32:15 +0000 (18:32 -0700)]
dataobject.tex had 2 instances of utf8 remaining due
to an oversight earlier. Now those use the textquoteright
command instead of the utf quote character.
Renamed tools charfix.py and charfix.sh to removeutf8.py and removeutf8.sh
as that is what they really do... remove utf8. There are no
remaining utf8 instances at the present time.
David Anderson [Sat, 4 May 2013 00:41:21 +0000 (17:41 -0700)]
Using removehyphen.py in tools to do
the actual work, this commit removes all the \-
from DW_ strings in .tex.
attributesbytag.tex
compression.tex
dataobject.tex
datarepresentation.tex
debugsectionrelationships.tex
dwarf5.tex
dwarfnamecmds.tex
examples.tex
generaldescription.tex
introduction.tex
otherdebugginginformation.tex
programscope.tex
typeentries.tex
David Anderson [Fri, 3 May 2013 21:21:43 +0000 (14:21 -0700)]
New script removehyphen.py fixes up the use of \-
by removing them.
Ron Brender [Thu, 2 May 2013 21:24:13 +0000 (17:24 -0400)]
Many small updates/corrections in responce to Committee review.
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Thu, 25 Apr 2013 21:34:54 +0000 (17:34 -0400)]
1) Change to T1 (instead of OT1) font encoding
2) Try out new fonts
3) Redo figure in Appendix B using TikZ
4) Ad hoc ff ligature fixups
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Fri, 19 Apr 2013 20:27:41 +0000 (16:27 -0400)]
This is the first pass of incorporating review commments from the
March/April review.
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Sun, 10 Feb 2013 10:08:00 +0000 (05:08 -0500)]
Final cleanups before group review. Only Appendix B Figure is pending...
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Fri, 8 Feb 2013 00:17:33 +0000 (19:17 -0500)]
Tweak sytle of numbered keyword lists to match that used in Chapter 6
(that is, use bold for the keyword).
[Similar changes are planned for the following Chapters.
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Sun, 3 Feb 2013 15:06:13 +0000 (10:06 -0500)]
More pagination cleanups using \needspace and \needlines.
Signed-off-by: Ron Brender <ron.brender@gmail.com>
Ron Brender [Sat, 2 Feb 2013 12:39:31 +0000 (07:39 -0500)]
Try out newly discovered needspace package; it is wonderful...
David Anderson [Fri, 1 Feb 2013 17:02:27 +0000 (09:02 -0800)]
datarepresentation.tex had a utf8 bullet character
still in the text. Now it is gone. latex is correctly
placing bullets where they should be, this one was a leftover
from the copy/paste operations which created the .tex.
David Anderson [Fri, 1 Feb 2013 16:53:17 +0000 (08:53 -0800)]
Removes the utf-8 strings from the .tex files and
replaces with latex commands to do the same job.
All the following had utf-8 in them till now.
Which came from the DWARF4 pdf creation process.
compression.tex datarepresentation.tex examples.tex
foreword4.1.tex generaldescription.tex gnulicense.tex
otherdebugginginformation.tex programscope.tex typeentries.tex
David Anderson [Fri, 1 Feb 2013 00:08:50 +0000 (16:08 -0800)]
This shell script charfix.sh is good for the one-time
removal of utf-8 characters.
Probably not useful again.
David Anderson [Thu, 31 Jan 2013 23:55:05 +0000 (15:55 -0800)]
Just fixing charfix.sh to be easier to do in stages.
Not part of the .tex. aiding utf-8 removal.
Ron Brender [Thu, 31 Jan 2013 23:15:15 +0000 (18:15 -0500)]
Complete figure to table conversion; other cleanups
Ron Brender [Mon, 28 Jan 2013 17:34:02 +0000 (12:34 -0500)]
Merge branch 'master' of dwarfstd.org:dwarf-doc
Ron Brender [Mon, 28 Jan 2013 17:28:34 +0000 (12:28 -0500)]
Change many figures to tables, lots of other fixes
Ron Brender [Sun, 20 Jan 2013 22:47:23 +0000 (17:47 -0500)]
convert sections back to figures in App D and E
Jason Molenda [Tue, 1 Jan 2013 12:17:43 +0000 (04:17 -0800)]
Add Mac OS X instructions for building a PDF.
Ron Brender [Thu, 20 Dec 2012 17:10:43 +0000 (12:10 -0500)]
Misc corrections in App B through end
Ron Brender [Thu, 20 Dec 2012 04:07:09 +0000 (23:07 -0500)]
Misc corrections Chpt 6 thru App A
Ron Brender [Tue, 18 Dec 2012 22:32:05 +0000 (17:32 -0500)]
Misc corrections up thru Chpt 5
Ron Brender [Mon, 17 Dec 2012 21:42:06 +0000 (16:42 -0500)]
Index entries for u (you) and other details
David Anderson [Fri, 7 Dec 2012 00:24:01 +0000 (16:24 -0800)]
These had a handful of spelling errors. None
of the errors are in DWARF4, they were introduced
to 4.1 in index entries, comments, and a couple times
in the text body.
datarepresentation.tex
dwarf5.tex
generaldescription.tex
otherdebugginginformation.tex
programscope.tex
typeentries.tex
David Anderson [Thu, 6 Dec 2012 23:35:25 +0000 (15:35 -0800)]
Adding to the tools, in the tools directory.
The new tool can fix up the utf-8 introduced
accidentally by copy/paste into the
current .tex. Changing it into proper latex
commands so all will then look right.
No change to any .tex file in this commit.
David Anderson [Thu, 6 Dec 2012 23:22:14 +0000 (15:22 -0800)]
Fixing 5 instances of \addtoindex[x] missing its leading backslash.
David Anderson [Wed, 5 Dec 2012 15:45:47 +0000 (07:45 -0800)]
Removing the small traces of DWARF5 from introduction, foreword, and
copyright chapters.
David Anderson [Tue, 4 Dec 2012 16:50:13 +0000 (08:50 -0800)]
Indexing letter 't' is complete in this change.
David Anderson [Mon, 3 Dec 2012 16:19:40 +0000 (08:19 -0800)]
Indexing letter 's'.
David Anderson [Sat, 1 Dec 2012 17:06:24 +0000 (09:06 -0800)]
Indexing o p q(none present) and r.
David Anderson [Thu, 29 Nov 2012 17:44:23 +0000 (09:44 -0800)]
Indexing m and n complete.
David Anderson [Tue, 27 Nov 2012 15:52:24 +0000 (07:52 -0800)]
Indexing l (letter ell).
David Anderson [Fri, 23 Nov 2012 16:20:06 +0000 (08:20 -0800)]
Indexing i and j is done.
David Anderson [Wed, 21 Nov 2012 20:22:47 +0000 (12:22 -0800)]
This indexes letters f, g, and h.
It also has additions for DW_AT_high_pc, low_pc, and ranges
that I noticed were incomplete.
Added a note to the document README on 'undefined' references:
They are part of the multi-pass nature of latex and not
always really undefined.
David Anderson [Sat, 17 Nov 2012 17:33:18 +0000 (09:33 -0800)]
Explaining, in the overall README for latex source, that
the tools directory is not something that most contributors
need to look at.
David Anderson [Sat, 17 Nov 2012 17:12:49 +0000 (09:12 -0800)]
This adds all the e* index entries present in DW4 into 4.1 latex.
David Anderson [Tue, 13 Nov 2012 17:53:01 +0000 (09:53 -0800)]
Corrects verbatim to be alltt in one crucial spot
so an example looks right and its attribute uses
are indexed.
typeentries.tex
David Anderson [Tue, 13 Nov 2012 03:25:46 +0000 (19:25 -0800)]
compression.tex
datarepresentation.tex
foreword.tex
generaldescription.tex
introduction.tex
otherdebugginginformation.tex
programscope.tex
sectionversionnumbers.tex
typeentries.tex
This completes the d* index entries.
At least a decent first cut at them.
David Anderson [Sat, 10 Nov 2012 17:41:55 +0000 (09:41 -0800)]
More d* index entries added.
David Anderson [Sun, 4 Nov 2012 17:54:00 +0000 (09:54 -0800)]
This does indexing of more d* words and phrases.
Ron Brender [Wed, 24 Oct 2012 14:33:07 +0000 (10:33 -0400)]
Index v and other stuff
Ron Brender [Sun, 21 Oct 2012 20:25:01 +0000 (16:25 -0400)]
Try .jpq version of DWlogo
David Anderson [Mon, 15 Oct 2012 16:38:57 +0000 (09:38 -0700)]
Indexing the b* entries, completed here.
A few "See Section" things were not proper \refersec, fixed thouse.
A few instances of "something" were present and those are now
in latex form ``something'' . Except in examples, where "" is
fine as is.
David Anderson [Wed, 10 Oct 2012 14:48:24 +0000 (07:48 -0700)]
Finished indexing the a* entries up through
'beginning of a data member'
David Anderson [Mon, 8 Oct 2012 22:26:07 +0000 (15:26 -0700)]
Updated date string in dwarf5.tex.
Fixed the attributes table in generaldescription.tex so
it uses lower case for indexing where appropriate instead
of the capitals appearing in the table itself.
David Anderson [Sun, 23 Sep 2012 21:44:16 +0000 (14:44 -0700)]
Indexes more entries starting with a.
Noticed livelink commands in the attributes table result in index entries
starting with capital letters, which was not my intent.
Changed some to livelinki and there are many more to do.
A few of the non-A language name entries were indexed too, though
there is more to do for the other language index entries.
David Anderson [Sun, 23 Sep 2012 21:35:36 +0000 (14:35 -0700)]
Changes to add index entries completing all of them up
through 'abstract'. In 4.1 Latex.
Not quite half of the first page of index entries
done once these committed.
Working through the abstract instance examples it was
natural to do some of the
concrete instance example indexing too.
Explained in READMEindexing how to get < and > characters to print.
David Anderson [Wed, 19 Sep 2012 18:04:40 +0000 (11:04 -0700)]
This shortens the often-long line of ....
in tools/dw4index.txt and tools/dw4sortedindex.txt
as we don't need all those dots for anything. They were
an artifact of copy/paste of the DWARF4 pdf index data.
David Anderson [Wed, 19 Sep 2012 18:01:21 +0000 (11:01 -0700)]
Adds index entries for all .debug_* and a couple other
index entries beginning with '.'.
The section-relationships page was missing .debug_types,
now that name is in its proper place (per the DW4 doc).