Hive CLI wiki -- draft ready to go

[Lefty Leverenz <le...@hortonworks.com>]

It's been a month without further comments, so I'm planning to swap out the
current CLI wikidoc next week, replacing it with this draft:

https://cwiki.apache.org/confluence/display/Hive/Revised+LanguageManual+Cli

Thanks to Sushanth Sowmyan for reviewing the draft.  Additional reviews are
welcome.

I'll make the swap on Thursday, August 30th.

– Lefty Leverenz


---------- Forwarded message ----------
From: Lefty Leverenz <le...@hortonworks.com>
Date: Tue, Jul 24, 2012 at 7:01 PM
Subject: Re: Hive CLI wikidoc review
To: dev@hive.apache.org


Okay, we can get rid of the xdoc but what about this information from it?

     The cli when invoked without the -i option will attempt to load
     HIVE_HOME/bin/.hiverc and $HOME/.hiverc as initialization files.

Is it still useful, or should I delete it from the draft?

– Lefty



On Tue, Jul 24, 2012 at 6:44 PM, Edward Capriolo <ed...@gmail.com>wrote:

> The xdoc should be removed its dead and out of sync.
>
> On Tue, Jul 24, 2012 at 7:21 PM, Lefty Leverenz <le...@hortonworks.com>
> wrote:
> > The Hive CLI<
> https://cwiki.apache.org/confluence/display/Hive/LanguageManual+Cli>
> > wikidoc
> > differs slightly from the xdocs
> > version<http://hive.apache.org/docs/r0.9.0/language_manual/cli.html>
> > (source-controlled
> > xml file) and they both need updating, so I merged them into a single
> > wikidoc for review by this community.  You can find the draft here:
>  Revised
> > LanguageManual CLI<
> https://cwiki.apache.org/confluence/display/Hive/Revised+LanguageManual+Cli
> >
> > .
> >
> > After the wikidoc has been reviewed and fixed, I'll apply the same
> changes
> > to the xdocs version.  Eventually only one copy should remain, but
> that's a
> > separate issue.  I'll be revising more wikidocs as time permits; the CLI
> > doc is first because diverging copies can cause trouble.
> >
> > Besides a simple merge, this draft includes technical changes based on
> > Thejas Nair's review comments as well as some editorial changes.  Please
> > let me know (or edit the draft) if you find any errors or want any
> changes.
> >  If more information is available, please provide it.
> >
> > Q1:  In the "Hive Resources" section is the syntax for DELETE FILE | JAR
> |
> > ARCHIVE correct?
> >
> > DELETE { FILE[S] | JAR[S] | ARCHIVE[S] } [<filepath1> <filepath2> ..]
> >
> >
> > Q2:  If DELETE does not require a filepath, what's the result – deleting
> *
> > all* files | jars | archives?
> >
> >
> > – Lefty Leverenz, *technical writer on a mission to improve Hive docs*
>