[jira] [Updated] (HBASE-3897) Docs (notsoquick guide) suggest invalid XML

["Philip Zeyliger (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/HBASE-3897?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Philip Zeyliger updated HBASE-3897:
-----------------------------------

    Attachment: HBASE-3897.patch.txt

Changes & to "and", since & renders an ampersand in the HTML, which then, when copy and pasted into the XML file, needs to be escaped again.  We could have done & instead, but that's just silly.

> Docs (notsoquick guide) suggest invalid XML
> -------------------------------------------
>
>                 Key: HBASE-3897
>                 URL: https://issues.apache.org/jira/browse/HBASE-3897
>             Project: HBase
>          Issue Type: Bug
>          Components: documentation
>            Reporter: Philip Zeyliger
>            Priority: Minor
>         Attachments: HBASE-3897.patch.txt
>
>
> If you follow http://hbase.apache.org/notsoquick.html, you'll put the following in your hbase-site.xml:
> {noformat}
> <configuration>
>   ...
>   <property>
>     <name>hbase.rootdir</name>
>     <value>hdfs://localhost:9000/hbase</value>
>     <description>The directory shared by region servers.
>     </description>
>   </property>
>   <property>
>     <name>dfs.replication</name>
>     <value>1</value>
>     <description>The replication count for HLog & HFile storage. Should not be greater than HDFS datanode count.
>     </description>
>   </property>
>   ...
> </configuration>
> {noformat}
> Except, oops, that's invalid XML:
> {noformat}
> [Fatal Error] hbase-site.xml:34:50: The entity name must immediately follow the '&' in the entity reference.
> Exception in thread "main" java.lang.RuntimeException: org.xml.sax.SAXParseException: The entity name must immediately follow the '&' in the entity reference.
> 	at org.apache.hadoop.conf.Configuration.loadResource(Configuration.java:1393)
> 	at org.apache.hadoop.conf.Configuration.loadResources(Configuration.java:1261)
> 	at org.apache.hadoop.conf.Configuration.getProps(Configuration.java:1192)
> 	at org.apache.hadoop.conf.Configuration.get(Configuration.java:415)
> 	at org.apache.hadoop.hbase.HBaseConfiguration.checkDefaultsVersion(HBaseConfiguration.java:63)
> 	at org.apache.hadoop.hbase.HBaseConfiguration.addHbaseResources(HBaseConfiguration.java:76)
> 	at org.apache.hadoop.hbase.HBaseConfiguration.create(HBaseConfiguration.java:86)
> 	at org.apache.hadoop.hbase.regionserver.HRegionServer.main(HRegionServer.java:2737)
> {noformat}
> Trivial patch to follow.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira