[ 
https://issues.apache.org/jira/browse/HIVE-4993?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13743165#comment-13743165
 ] 

Lefty Leverenz commented on HIVE-4993:
--------------------------------------

The HCat docs are all converted to wikidocs.  You can find them here:

* HCatalog home page: 
[https://cwiki.apache.org/confluence/display/Hive/HCatalog]
** Overview: 
[https://cwiki.apache.org/confluence/display/Hive/HCatalog+Overview]
** Installation from Tarball: 
[https://cwiki.apache.org/confluence/display/Hive/HCatalog+Install]
** Load and Store Interfaces: 
[https://cwiki.apache.org/confluence/display/Hive/HCatalog+LoadStore]
** Input and Output Interfaces: 
[https://cwiki.apache.org/confluence/display/Hive/HCatalog+InputOutput]
** Reader and Writer Interfaces: 
[https://cwiki.apache.org/confluence/display/Hive/HCatalog+ReaderWriter]
** Command Line Interface: 
[https://cwiki.apache.org/confluence/display/Hive/HCatalog+CLI]
** Storage Formats: 
[https://cwiki.apache.org/confluence/display/Hive/HCatalog+StorageFormats]
** Dynamic Partitioning: 
[https://cwiki.apache.org/confluence/display/Hive/HCatalog+DynamicPartitions]
** Notification: 
[https://cwiki.apache.org/confluence/display/Hive/HCatalog+Notification]
** Storage Based Authorization: 
[https://cwiki.apache.org/confluence/display/Hive/HCatalog+Authorization]


Some of them need review & revision.  In particular:

# Installation 
([https://cwiki.apache.org/confluence/display/Hive/HCatalog+Install]) starts 
with this disclaimer:
#* "This information is adapted from the HCatalog 0.5.0 installation 
instructions. Now that HCatalog is part of the Hive project, it is installed 
with Hive and therefore much of the information below is obsolete. Furthermore, 
there is no such thing as 'HCatalog 0.11.0' although that fiction has been 
substituted below for 'HCatalog 0.5.0' — until this wikidoc is revised to 
reflect current realities, you should be skeptical of what you read here."
# Load and Store has obsolete version numbers for jars 
([https://cwiki.apache.org/confluence/display/Hive/HCatalog+LoadStore#HCatalogLoadStore-JarsandConfigurationFiles])
 so I just called them 0.5.0 examples but they should be updated: 
#* The version number found in each filepath will be substituted for *. For 
example, HCatalog release 0.5.0 uses these jars and conf files:
#** $HCAT_HOME/share/hcatalog/hcatalog-core-0.5.0.jar
#** $HCAT_HOME/share/hcatalog/hcatalog-pig-adapter-0.5.0.jar
#** $HIVE_HOME/lib/hive-metastore-0.10.0.jar
#** $HIVE_HOME/lib/libthrift-0.7.0.jar
#** $HIVE_HOME/lib/hive-exec-0.10.0.jar
#** $HIVE_HOME/lib/libfb303-0.7.0.jar
#** $HIVE_HOME/lib/jdo2-api-2.3-ec.jar
#** $HIVE_HOME/conf
#** $HADOOP_HOME/conf
#** $HIVE_HOME/lib/slf4j-api-1.6.1.jar
# Storage Formats 
([https://cwiki.apache.org/confluence/display/Hive/HCatalog+StorageFormats]) 
might need updates for two sentences:
#* "SerDes are provided for RCFile, CSV text, JSON text, and SequenceFile 
formats." --- What about ORC?
#* "However, Hive does not know where to find the HCatalog jar by default, ..." 
--- Is that still true?
# Authorization's section on Minimum Permissions 
([https://cwiki.apache.org/confluence/display/Hive/HCatalog+Authorization#HCatalogAuthorization-MinimumPermissions])
 has needed more information since it first appeared, but nobody had time for 
it.

                
> Add HCatalog documentation to Hive wiki
> ---------------------------------------
>
>                 Key: HIVE-4993
>                 URL: https://issues.apache.org/jira/browse/HIVE-4993
>             Project: Hive
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 0.11.0
>            Reporter: Lefty Leverenz
>            Assignee: Lefty Leverenz
>
> The documentation for HCatalog versions 0.5.0 and earlier (Apache incubator) 
> had xml source files which generated html & pdf output files.  Now that 
> HCatalog is part of the Hive project, the HCatalog documents need to be added 
> to the Hive wiki.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Reply via email to