My attempt to always have the documentation built before windows and macOS 
build backfired. "monitoring" the documentation build resulted in Windows and 
macOS building as soon as there was a change to the documentation, also when 
there is no change to the source codebase. So I have reverted that change.

The other way around, to have Windows and/or initiating a documentation build 
for every source code change might work (the documentation build will exit 
silently if there are no changes) but I think it will eventually lead to 
problems. In the normal situation the documentation will be fairly stable so 
ready to be picked up. For a release scenario we might need to be a bit more 
disciplined and let a couple of hours pass between documentation changes and 
final build. I hope this is acceptable.

I have amended the script building and uploading the documentation to accept 
download and upload paths, so that is can be driven by cMake when we know how 
to use that as variables.

Along the same lines I have written yet a rexx script that checks if any 
changes have been made to docs-bildutils, and if so, update the "Files" section 
of sourceforge so that we now have an automated way to update also 
docs-bildutils

The script is launched from the Project ooRexx-docs-bildutils-check and 
hopefully we can provide the necessary input to the script from CMakeLists.txt 
in a later stage.

I did only consider files so far, I have a question on the folders rexxpg 
bldoc_win bldoc_orx

rexxpg only contain two files so it is doable to download them using the 
enerving "wait five seconds" downloading function but for bldoc_win and 
bldoc_orx (what is the difference) there are some 20 separate files and 
folders, making downloading it a nightmare. I suggest to put everything 
together as a zipfile, in that way it is a one-click to get it.

The folder publican_obsolete is just that, obsolete, so I do not expect anyone 
to use it but it is kept for backwards compatibility.

In the coming days I will go through the list and see what is missing on my 
part and delete/summarize those sections.

Sorry about the long mail

Hälsningar/Regards/Grüsse,
P.O. Jonsson
oor...@jonases.se



_______________________________________________
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel

Reply via email to