Thanks for catching this Mohammad, it looks like this commit changed the
source on 3.5 branch but the generated docs were not re-generated:

+  ZOOKEEPER-2402: Document client side properties (Arshad Mohammad via fpj)

svn commit: r1745280 - in /zookeeper/branches/branch-3.5: CHANGES.txt
src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml
src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml

As a result the published documentation is out of date with the source.

We have a few options, including but not limited to: 1) fix it during the
next release (i.e. ignore it for now), 2) someone could regenerate the
documentation for that release and update the published docs manually.
others?

Patrick


On Mon, Aug 8, 2016 at 8:24 AM, Mohammad arshad <[email protected]>
wrote:

> http://zookeeper.apache.org/doc/r3.5.2-alpha/ is not showing the
> documentation which is released with zookeeper-3.5.2-alpha
> Released tar ball has up to date documentation source but the generated
> document is still old.
>
> For example:
> src\docs\src\documentation\content\xdocs\zookeeperProgrammers.xml has
> bellow content
> <varlistentry>
>                <term>zookeeper.sasl.client</term>
>                <listitem>
>                               <para>Set the value to <emphasis
> role="bold">false</emphasis> to disable
>                               SASL authentication. Default is <emphasis
> role="bold">true</emphasis>.</para>
>                </listitem>
> </varlistentry>
> But  generated document file docs/zookeeperProgrammers.html does not have
> above content.
>
> -Arshad
>
>

Reply via email to