This is the mail archive of the xconq7@sources.redhat.com mailing list for the Xconq project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Updated files


I have some file updates to make.  Should I send them to directly to Hans, or just attach tthem to an email for the group.  Also, I can send tar, gar.gz, or zip formatted files, or individual ascii files.  Which is the preferred format?

The biggest change is in refman.texi, where I'm adding anchors to cross reference the GDL and the runtines in the code.  I'm still working on a way to document the .def files, which turns out to be moderatly important to understanding the code.  What I may have to do is create some special .h files int the doc directory, and rnun the C preprocessor on them, then do a merge with a documentation file if they change.  A bit of a pain, but so it goes.

Oh, and the texi file changes require upgrading to a newer version of texi2html in order to process @html and @image tags in texi.  Thee is still a bug in that I'm getting both the @ifinfo and @ifhtml parts of text I have in the texi files, but I think that will be fixed fairly soon.  One disagvantage of the newer texi2html program is that it visually splits the html file into sections, but doesn't physically split it into .html files.


But I feel that being able to crsoss reverence code and the manulas is a useful capability in the documenation, so I'm putting some work into being able to do it.  Mostly adding invisible anchors for ever GDL @deffn section.  I'd sue texi2html's anchors, but if you re-arrange, add, or remove sections or definitions, the tags change.  And you can't guess what they'll be ahead of time, whereas I'm using the convention of "GDL_ref_xxxx" where xxx is the name of the variable, form, table, ...  So for example acp_to_disband would have the anchor "GDL_ref_acp-to-disband"  

Oh, if anyone can convert jpg's to eps's, Id appreaciate them converting a couple of files for me to replace some to the "crude text" images for latex versions of the manuals





_______________________________________________
Can a Web portal forever change your life?
Win up to $25 Million on iWon - click here!


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]