[PROJ] proj manual, versioning, download location
Kristian Evers
kreve at sdfe.dk
Sun Jan 5 23:47:53 PST 2020
> We could indeed include that as part of the release process to create a
> Snapshot
It would be great to have this as part of the "make dist" step in the release
process. The same goes for the man-pages. I don't think that it is too
complicated to set up.
/Kristian
-----Original Message-----
From: PROJ <proj-bounces at lists.osgeo.org> On Behalf Of Even Rouault
Sent: 5. januar 2020 19:31
To: proj at lists.osgeo.org
Subject: Re: [PROJ] proj manual, versioning, download location
Greg,
> I wondered how it was versioned, and see that it is freshly generated
> for 6.3.0.
It is actually generated as part of the continuous integration:
https://github.com/OSGeo/PROJ/blob/master/travis/build_docs.sh
https://github.com/OSGeo/PROJ/blob/master/travis/deploy_website.sh
and the later stage is only applied for the current stable branch:
https://github.com/OSGeo/PROJ/blob/6.3/travis/after_success.sh#L14
>
> It would be really nice if this were at
>
> https://download.osgeo.org/proj/
>
> as
>
> proj-manual-6.3.0.pdf
>
> or something like that. This would make it easier to include in binary
> packages, because:
>
> The file would be versioned, so that someone with e.g. 6.2.1 package
> control files could still build that package with the 6.2.1 manual.
> (In general, packaging systems aim to be reproducible, which leads to
> a ddislike of URLs with variable contents.)
>
> It would be downloadable from the same base URL, which makes life
> easier.
If you want a manual of 6.3.0, you can replicate that with something along the
following lines:
- checkout the 6.3.0 git tag
- install doxygen & graphviz packages
- pip3 install sphinxcontrib-bibtex
- cd docs; make .doxygen_up_to_date latexpdf
- results is in docs/build/latex/proj.pdf
We could indeed include that as part of the release process to create a
snapshot
Even
--
Spatialys - Geospatial professional services
http://www.spatialys.com
_______________________________________________
PROJ mailing list
PROJ at lists.osgeo.org
https://lists.osgeo.org/mailman/listinfo/proj
More information about the PROJ
mailing list