Project

Profile

Help

Bug #5843

closed

SaxonC releases readme

Added by Debbie Lockett over 1 year ago. Updated about 1 year ago.

Status:
Closed
Priority:
Low
Category:
-
Start date:
2023-01-20
Due date:
% Done:

100%

Estimated time:
Found in version:
Fixed in version:
12.1
Platforms:

Description

For SaxonC 12, the release zips now contain a top level README.md file. This was modified from the readme which was previously only used to generate the index.html page of the C++ API documentation.

  1. The readme used for the C++ API documentation should be changed back to make more sense there.
  2. The readme for SaxonC releases should be reviewed further (e.g. compare this to the doc/index.html file which goes in SaxonJ releases).
Actions #1

Updated by Debbie Lockett over 1 year ago

  • File deleted (index.html)
Actions #2

Updated by Debbie Lockett over 1 year ago

I've committed changes to separate the readmes:

  • src/main/c/README.md is the one for the releases (containing @@ terms which get replaced accordingly for different editions, etc.)
  • src/main/c/Saxon.C.API/README.md is the one used by doxygen for the C++ API documentation.

It would be good to exclude the file Saxon.C.API/README.md from the releases entirely, to avoid confusion (and in fact I think the Doxyfile could be excluded too), but I have not yet worked out where in the build to amend this.

Actions #3

Updated by O'Neil Delpratt over 1 year ago

I have made the change to exclude src/main/c/Saxon.C.API/README.md in the cradle build script.

Actions #4

Updated by Debbie Lockett about 1 year ago

  • Status changed from In Progress to Resolved

Further build script changes committed to correctly exclude src/main/c/Saxon.C.API/README.md (and other Saxon.C.API content which was mistakenly copied).

Releases readme src/main/c/README.md content updated to add more links for documentation, bug tracker, etc.

Actions #5

Updated by O'Neil Delpratt about 1 year ago

  • Status changed from Resolved to Closed
  • % Done changed from 0 to 100
  • Fixed in version set to 12.1

Bug fixed applied in the SaxonC 12.1 maintenance release.

Please register to edit this issue

Also available in: Atom PDF