Hi Gil, that looks great! I hope we can build the docs on Jenkins so that will be available when we need it. Probably P.O. can help us with this. Do you only build doc on Windows or also Linux?
best regards, René > On 16 Dec 2019, at 11:40, Gil Barmwater <[email protected]> wrote: > > As a result of Jon's request, I have now done the RxMath PDF as well. Doing > another document helped me formalize the process so that I can automate it > and it identified another small issue which I thought had been corrected. You > can download the PDF here > <https://www.dropbox.com/s/82yxqei5ucvub9e/rxmath.pdf?dl=0> for comparison to > the rxmath.pdf that is in the docs folder of your 5.0.0 ooRexx installation > or the Files section on SourceForge. The differences I found are 1) the > Copyright dates on the second page now show -2019, and 2) the flow of the > text in some sections is slightly different due to extra blank lines in the > code examples. This issue was identified and fixed by Erich with a preprocess > Rexx program when building our docs using Publican so it can be adapted to my > process if I am unable to find the cause and change it. His program also > needed to fix blank lines in the Index area but that looked OK to me in my > build. Comments welcome. > > Gil > > ------------------------------------------------------------------------------------------------------------------------------------------------------------ > > Jon, > > Yes, of course you are right, I need to do a more complex document to see if > there are other issues in addition to those I've identified so far. Stay > tuned... > > On 12/11/2019 2:19 PM, Jon Wolfers wrote: >> Hi Gil, >> >> Looks good to me, but I'm not sure what to look for. Any chance of a doc >> with railroad diagrams? >> >> Jon >> >> On Wed, 11 Dec 2019, 19:00 Gil Barmwater, <[email protected] >> <mailto:[email protected]>> wrote: >> Thanks for the feedback Rony. Anyone else have any comments? If not, I will >> start posting comments on the issues I have found shortly. My goal is to >> develop a package containing the tools that anyone can download and install >> that will allow them to build our docs on Windows 10 from a fresh checkout >> from SourceForge with minimal changes to those files. >> >> On 12/10/2019 12:45 PM, Rony G. Flatscher wrote: >>> Wow, that is *fantastic* news!! Also, looking at your readme.pdf it looks >>> terrific IMHO! >>> >>> Very curious what you have come up with to be able to generate the ooRexx >>> 5.0 documentation yourself� (and also about the questions that you will >>> pose in order to learn about the current problems from them and become able >>> to build the ooRexx documentation in the near future and in a future-safe >>> way)! >>> >>> Kudos! >>> >>> ---rony >>> >>> On 10.12.2019 18:17, Gil Barmwater wrote: >>>> I know it has been over a month since I posted the note below but I now >>>> have a lot of progress to report! I have obtained the tools needed to >>>> build our docs - they are open source and seem well supported - and have >>>> successfully built one document using them on Windows 10. There are no >>>> dependencies on Publican other than three files I chose to retain to >>>> simplify the transition. Installing and using the tools was pretty >>>> painless but in doing so I uncovered a number of issues with our >>>> documents, most of which are due to our use of Publican and what it does >>>> "under the covers". Rather than turning this email into >>>> a "book", I will send separate notes on each issue and the changes needed >>>> in order to use the new tools. In the meantime, here >>>> <https://www.dropbox.com/s/n7p09b6zm0vghqc/readme.pdf?dl=0> is a link to a >>>> file in my Dropbox for the readme.pdf that I built. Once the link opens in >>>> your browser, you can click on the ... icon on the right which will open a >>>> menu that will allow you to download the file. If you then compare it to >>>> the readme.pdf that is in the docs folder of your 5.0.0 ooRexx >>>> installation or the Files section on SourceForge, you will see it is >>>> (almost) identical. The differences are 1) the text has been updated in >>>> section 2.2, 2) the Copyright dates on the first page now show -2019, 3) >>>> the flow of the text in some sections is slightly different, in some cases >>>> causing text to flow to the next page, and 4) the Table of Contents has >>>> more levels listed. I did not feel that either of the last two items were >>>> worth pursuing. Let me know what you think after you've had a look. >>>> >>>> Gil B. >>>> >>>> -------------------------------------------------------------------------------------------------------------------------------------------------------------- >>>> Just so everyone doesn't think I've abandoned this effort, I am pursuing >>>> another approach to building the docs. You can expect an update when I've >>>> made some more progress. >>>> >>>> >>>> On 11/4/2019 4:16 PM, Gil Barmwater wrote: >>>>> ?I will go back to docbook.org <http://docbook.org/> and do some more >>>>> reading before proceeding any further with Pandoc. >>>>> >>>> -- >>>> Gil Barmwater >>> >>> >>> >>> >>> _______________________________________________ >>> Oorexx-devel mailing list >>> [email protected] >>> <mailto:[email protected]> >>> https://lists.sourceforge.net/lists/listinfo/oorexx-devel >>> <https://lists.sourceforge.net/lists/listinfo/oorexx-devel> >> -- >> Gil Barmwater >> _______________________________________________ >> Oorexx-devel mailing list >> [email protected] >> <mailto:[email protected]> >> https://lists.sourceforge.net/lists/listinfo/oorexx-devel >> <https://lists.sourceforge.net/lists/listinfo/oorexx-devel> >> >> >> >> _______________________________________________ >> Oorexx-devel mailing list >> [email protected] >> <mailto:[email protected]> >> https://lists.sourceforge.net/lists/listinfo/oorexx-devel >> <https://lists.sourceforge.net/lists/listinfo/oorexx-devel> > -- > Gil Barmwater > _______________________________________________ > Oorexx-devel mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/oorexx-devel
_______________________________________________ Oorexx-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/oorexx-devel
