On Thu, Apr 25, 2013 at 6:43 AM, Christopher <[email protected]> wrote:
> Oh, and would it be simpler to call the Java code, instead of > interacting with the shell in a script? Similar to what is done to > generate docs/config.html? > *shrug* Interacting with the Shell in Java and replicating what HelpCommand does sounds uglier to me. I'd rather make sure that shell --fake works, but I'm not sure why that's broken sometimes. Is it harder to use a script with maven? Billie > > -- > Christopher L Tubbs II > http://gravatar.com/ctubbsii > > > On Thu, Apr 25, 2013 at 9:40 AM, Christopher <[email protected]> wrote: > > Well, whatever is done, I just want to ensure it's automated, so that > > the PDF (if we're going to generate one) is one of the build artifacts > > that is included in release candidate voting, without a lot of manual > > steps. > > > > -- > > Christopher L Tubbs II > > http://gravatar.com/ctubbsii > > > > > > On Wed, Apr 24, 2013 at 10:09 PM, Billie Rinaldi > > <[email protected]> wrote: > >> On Wed, Apr 24, 2013 at 3:04 PM, Christopher <[email protected]> > wrote: > >> > >>> I noticed that there's a script that grabs shell output and builds an > >>> appendix for the user manual PDF. However, that doesn't appear to be > >>> automated as part of the documentation build profile. > >>> > >>> So, the questions are: > >>> 1) Do we need this? > >>> > >> > >> Well, it's kind of nice to have all the usage collected together. I > feel > >> like I've looked something up there, but not for a while. Does anyone > else > >> use it? It doesn't just run `help`, it gets the full command listing > from > >> `help` and then runs help on each command. > >> > >> > >>> 2) Does it need to be run manually? > >>> > >> > >> It doesn't need to be updated very often. Whether it could be automated > >> depends on the state of accumulo --fake. > >> > >> > >>> > >>> Also, I guess there's some extra steps to convert the LaTeX source for > >>> the PDF into HTML... regarding that: > >>> > >> > >> I like having the manual as html in addition to pdf. I'm playing around > >> with asciidoc to see if it supports everything we need for the manual. > It > >> would be much better not to have to do the latex to html process again. > >> > >> Billie > >> > >> > >>> > >>> 1) are those steps documented anywhere? > >>> 2) can we automate that procedure? > >>> 3) do we even need it? > >>> > >>> Personally, I think it'd be better to just do the PDF for now, until > >>> we get Doxia or something similar working. > >>> > >>> -- > >>> Christopher L Tubbs II > >>> http://gravatar.com/ctubbsii > >>> >
