Revision: 57127
http://sourceforge.net/p/brlcad/code/57127
Author: tbrowder2
Date: 2013-08-25 20:19:46 +0000 (Sun, 25 Aug 2013)
Log Message:
-----------
add info from Eric Raymond ref doclifter
Modified Paths:
--------------
brlcad/trunk/doc/burst/README
Modified: brlcad/trunk/doc/burst/README
===================================================================
--- brlcad/trunk/doc/burst/README 2013-08-25 20:18:50 UTC (rev 57126)
+++ brlcad/trunk/doc/burst/README 2013-08-25 20:19:46 UTC (rev 57127)
@@ -1,3 +1,64 @@
Documentation for the BRL-CAD program 'burst'.
Debian requires packages groff and groff-base.
+
+The original source file ('burst.mm') has been modified slightly to
+ensure correct handling by Eric Raymond's doclifter
+(http://www.catb.org/~esr/doclifter/). From an e-mail from Eric:
+
+from: Eric S. Raymond <[email protected]>
+reply-to: [email protected]
+to: Tom Browder <[email protected]>
+date: Tue, Aug 20, 2013 at 8:48 AM
+subject: Re: doclifter (master) failing on troff mm source
+mailed-by: thyrsus.com
+
+<quote>
+Tom Browder <[email protected]>:
+> I have checked all macros and they are valid mm macros so I can't
+> figure out why doclifter is failing. I can send you the whole source
+> zipped if you're interested.
+
+What you sent is sufficient. The problem is that your mm file
+contains none of the three trigger macros doclifter is looking for as
+a way to recognize that it's dealing with mm - .MT, .SA, or .COVER.
+The relevant table looks like this:
+
+# This is how we autodetect the right macro set:
+
+interpreter_dispatch = {
+ "pp": MeInterpreter,
+ "Dt": MdocInterpreter,
+ "Dd": MdocInterpreter,
+ "Nm": MdocInterpreter,
+ "AU": MsInterpreter,
+ "NH": MsInterpreter,
+ "TH": ManInterpreter,
+ "MT": MmInterpreter,
+ "SA": MmInterpreter,
+ "COVER": MmInterpreter,
+ # Extension macro sets
+ "supplemental macros used in Tcl/Tk": TkManInterpreter,
+ "BS": TkManInterpreter,
+ "the F register is turned on": Pod2ManInterpreter,
+ "ZN": XManInterpreter,
+ "Pn": XManInterpreter,
+ "ny0": XManInterpreter,
+ "reStructuredText": reStructuredTextInterpreter,
+ "reStructeredText": reStructuredTextInterpreter,
+ "DocBook XSL Stylesheets" : DocBookInterpreter,
+ "pdfdest" : FoojzsInterpreter,
+ "H0": ASTInterpreter,
+ # These are all of the supported Mwww tags
+ "URL": MwwwInterpreter,
+ "FTP": MwwwInterpreter,
+ "MTO": MwwwInterpreter,
+ "PIMG": MwwwInterpreter,
+ "IMG": MwwwInterpreter,
+ "TAG": MwwwInterpreter,
+ }
+
+Inserting a dummy .MT 0 call should fix your problem.
+</quote>
+
+
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
------------------------------------------------------------------------------
Introducing Performance Central, a new site from SourceForge and
AppDynamics. Performance Central is your source for news, insights,
analysis and resources for efficient Application Performance Management.
Visit us today!
http://pubads.g.doubleclick.net/gampad/clk?id=48897511&iu=/4140/ostg.clktrk
_______________________________________________
BRL-CAD Source Commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/brlcad-commits
