On Sun, Feb 26, 2012 at 23:38, Clifford Yapp <[email protected]> wrote:
...
>> Looks like a fix didn't work--still get the message. It seems to me
>> we need an INSTALL.in file that's versioned and let cmake construct
>> the unversioned INSTALL from it plus its addidions from the
>> CMakeLists.txt files.
>
>
> Crud - copy/paste error - sorry. Give 49561 a try.
Okay, that works--no error message.
Cliff, I slept on this and I propose another look at this whole
doc/xtradoc//html/pdf issue: I am very confused with the current build
state and doc options.
1. Somewhere in INSTALL or HACKING we need to tell users what they
need to produce pdf. There mention any environment variables that
affect the process (such as APACHE_FOP).
As an aside:
+ I also think that ALL input files versioned for the cmake system
should be named *.in (except, of course, for CMakeLists.txt) and any
generated files under our control should be named *.cmake.autogen and
be eligible to be blown away (and also ignored by subversion).
+ We should also have some separate doc make targets, e.g., "doc", "pdf", etc.
2. From my experiments with the current revision (49561), the doc
options are these (in order as I visualize a natural sequence):
a. man+xtra: html <== BRLCAD_EXTRADOCS=ON (default)
b. man: html <== BRLCAD_EXTRADOCS=OFF
c. man+xtra: html, pdf <== BRLCAD_EXTRADOCS_PDF=ON
d. man+xtra: html
xtra: pdf <== BRLCAD_EXTRADOCS_PDF_MAN=OFF
(seems to require BRLCAD_EXTRADOCS_PDF=ON)
Output from cmake for those options:
a. Generate extra docs ...................: ON (man/html only)
b. Generate extra docs ...................: OFF
c. Generate extra docs ...................: ON (man/html/pdf)
d. Generate extra docs ...................: ON (man/html/pdf)
I don't see any practical reason to generate man or extra docs html
alone so I eliminate one of the above. I think the options should be
renamed to reflect a more natural sequence, something like this (none
require any of the others to be ON):
a. man+xtra: html <== BRLCAD_ALLDOCS=ON
(default)
b. a + man+xtra: pdf <== BRLCAD_ALLDOCS_PDF=ON
(default OFF)
c. a + xtra: pdf <== BRLCAD_EXTRADOCS_PDF=ON
(default OFF)
d: no docs <== BRLCAD_ALLDOCS=OFF
Output from cmake would be something like:
a. Generate docs ................: man+xtra: html
b. Generate docs ................: man+xtra: html, pdf
c. Generate docs ................: man: html; xtra: html, pdf
d. Generate docs ................: OFF
And if a user chooses a pdf option and cmake can't find the required
files, the user should be notified what is missing.
Thoughts?
Best regards,
-Tom
------------------------------------------------------------------------------
Try before you buy = See our experts in action!
The most comprehensive online learning library for Microsoft developers
is just $99.99! Visual Studio, SharePoint, SQL - plus HTML5, CSS3, MVC3,
Metro Style Apps, more. Free future releases when you subscribe now!
http://p.sf.net/sfu/learndevnow-dev2
_______________________________________________
BRL-CAD Developer mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/brlcad-devel
