Mailing-List: contact dev-help@accumulo.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@accumulo.apache.org
Received-SPF: pass (athena.apache.org: domain of billie.rinaldi@gmail.com
 designates 209.85.214.182 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <CAGUtCHrN_AgO_HEMqFz+6tGL6My=Bh+g2dhKWAk8+r0hV0OEAg@mail.gmail.com>
References: 
 <CAL5zq9aK=0F_qN2ODw8Rjc6dwrvJBeVQ2W=D4yA3BX3OPaSbcQ@mail.gmail.com>
	<CAGUtCHrN_AgO_HEMqFz+6tGL6My=Bh+g2dhKWAk8+r0hV0OEAg@mail.gmail.com>
Date: Thu, 25 Apr 2013 09:48:06 -0700
Message-ID: 
 <CAF1jEfBhRhERKiuqub1AX0td8BrZCxkLLMjkkq9i6fPcbnUx8g@mail.gmail.com>
Subject: Re: Shell documentation appendix
From: Billie Rinaldi <billie.rinaldi@gmail.com>
To: dev@accumulo.apache.org
Content-Type: multipart/alternative; boundary=089e0153827ecc07b404db322ea8

--089e0153827ecc07b404db322ea8
Content-Type: text/plain; charset=ISO-8859-1

On Thu, Apr 25, 2013 at 9:38 AM, Keith Turner <keith@deenlo.com> wrote:

> On Wed, Apr 24, 2013 at 6:04 PM, Christopher <ctubbsii@apache.org> 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?
> >
>
> For 1.5, it seems like we have the following options.
>
>  1. Update it to reflect the commands that exist in 1.5.
>  2. Drop it.
>  3. Leave it as is.
>
> Whats the current status of this documentation?  Is it based on 1.4 shell
> commands?  If so then, option 3 would mean shipping 1.5 w/ documentation
> for 1.4 shell commands.  Can option 1 be done quickly for 1.5?
>

Yes, it can be done easily.  The get_shell_commands script outputs a new
appendix.  I'm happy to do this if we still think the appendix is useful.


>
>
> > 2) Does it need to be run manually?
> >
> > Also, I guess there's some extra steps to convert the LaTeX source for
> > the PDF into HTML... regarding that:
> >
> > 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
> >
>

--089e0153827ecc07b404db322ea8--