[lsst-dm-stack-users] Some notes about eups manual on LSST

[Fabrice Jammes]

Hello Robert,

Thanks a lot for your help.

About the second point :

- i've used pandoc to convert from latex to rst. The output is attached (i
had to quick fix lines 664 and 2583).
sphinx then generates a reasonable correct html for this.

- you're right, eups is successfully installed even if tex packages aren't
available, but the above error message worried me so that i was not sure
it has worked.

$ make install
...
make[1]: Leaving directory `/opt/src/eups/python'
In site
make[1]: Entering directory `/opt/src/eups/site'
/opt/lsst/site/startup.py exists; not overwriting
make[1]: Leaving directory `/opt/src/eups/site'
In ups
make[1]: Entering directory `/opt/src/eups/ups'
cp eups.table /opt/lsst/eups/ups
make[1]: Leaving directory `/opt/src/eups/ups'
In doc
make[1]: Entering directory `/opt/src/eups/doc'
/bin/sh: 1: latex: not found
Could not build eups.aux (ignoring)
/bin/sh: 1: pdflatex: not found
Could not build eups.pdf (ignoring)
Running latex2html
/bin/sh: 1: latex2html: not found
latex2html failed; writing dummy eups.html
cp: cannot stat ‘eups.pdf’: No such file or directory
Not all documentation files copied (ignoring)
make[1]: Leaving directory `/opt/src/eups/doc'

Indeed you're right, it perfectly works even if tex packages aren't
installed, but it seems not so clear for a new user.

Thanks again for your help and have a nice day,

Fabrice


On Wed, November 13, 2013 7:15 pm, Robert Lupton the Good wrote:
> Dear Fabrice,
>
>
> you make two points here -- let's address both!
>
>> 1. The LSST manual page relative to eups installation
>> (https://dev.lsstcorp.org/trac/wiki/EupsManual#SECTION000400000000000000
>> 00) needs to be updated. Indeed it points to an obsolete tar.gz version
>> and code repository. Robert Lupton The Good gave the correct
>> informations about these pointer in his answer to ticket 3052
>> https://dev.lsstcorp.org/trac/ticket/3052
>>
>
> Robyn, can you fix this?
>
>
>> 2. Furthermore it seems eups build depends on next packages :
>> sudo apt-get install texlive-binaries texlive-latex-base It would be good
>> to make these dependencies optional so that no root access are required
>> to build and install eups. For example the documentation could be made
>> also available in markdown or rst (sphinx source) format ?
>
> I'm a bit surprised that the installation fails if you don't have
> pdflatex in your path [although I agree that you won't get a copy of the
> manual].  OK, I just checked, and make returns 0 even if
> latex/pdflatex/latex2html are unavailable.
>
> I haven't looked at whether there's an latex2rst converter (or whether
> it'd be trivial to write one).  An alternative would be to check the .pdf
> and .html versions into git, although I'm not generally in favour of
> checking in generated files.  We should certainly do this for install
> tarballs.
>
> R
>
>
>