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

[Fabrice Jammes]

Hello,

Sorry, i've forgot to attach the rst file. it's now here.

Fabrice

On Fri, November 15, 2013 3:11 am, Fabrice Jammes wrote:
> 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#SECTION0004000000000000
>>> 00
>>> 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
>>
>>
>>
>>
>
>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: index.rst
Type: application/octet-stream
Size: 105827 bytes
Desc: not available
URL: <https://listserv.lsstcorp.org/pipermail/dm-users/attachments/20131115/875e7d93/attachment.obj>