[PROJ] proj manual, versioning, download location

[Even Rouault]

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