You are viewing a plain text version of this content. The canonical link for it is here.
Posted to common-issues@hadoop.apache.org by "Eli Collins (JIRA)" <ji...@apache.org> on 2011/01/05 01:46:47 UTC
[jira] Created: (HADOOP-7085) Cluster setup docs link to the wrong
default config files
Cluster setup docs link to the wrong default config files
---------------------------------------------------------
Key: HADOOP-7085
URL: https://issues.apache.org/jira/browse/HADOOP-7085
Project: Hadoop Common
Issue Type: Bug
Components: documentation
Reporter: Eli Collins
Priority: Minor
The mapred and hdfs default links on the following page are broken. Looking into the cause, the links always point to the current docs so old generated docs have the wrong pointers (they should point to docs/<release> instead of docs/current). This is because cluster_setup.xml uses site.xml which defines references to the docs using http://hadoop.apache.org/core/docs/current.
http://hadoop.apache.org/common/docs/r0.20.2/cluster_setup.html
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (HADOOP-7085) Documentation uses urls with
"current"
Posted by "Eli Collins (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/HADOOP-7085?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Eli Collins updated HADOOP-7085:
--------------------------------
Summary: Documentation uses urls with "current" (was: Cluster setup docs link to the wrong default config files)
On trunk a lot of the documentation uses the current symlink, so generated docs for an old release contain pointers to new documentation that the release does not support.
I think these links should be relative links, looks like they're using absolute urls because they point to generated files and forrest will complain about broken links if relative links are specified and the target files do not exist when forrest is run. One fix is to create empty xml files (eg core-default.xml etc) in the docs that are later over-written. This way forrest won't complain about the relative link (and the link will point to the appropriate document).
> Documentation uses urls with "current"
> --------------------------------------
>
> Key: HADOOP-7085
> URL: https://issues.apache.org/jira/browse/HADOOP-7085
> Project: Hadoop Common
> Issue Type: Bug
> Components: documentation
> Reporter: Eli Collins
> Priority: Minor
>
> The mapred and hdfs default links on the following page are broken. Looking into the cause, the links always point to the current docs so old generated docs have the wrong pointers (they should point to docs/<release> instead of docs/current). This is because cluster_setup.xml uses site.xml which defines references to the docs using http://hadoop.apache.org/core/docs/current.
> http://hadoop.apache.org/common/docs/r0.20.2/cluster_setup.html
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] [Updated] (HADOOP-7085) Documentation uses urls with
"current"
Posted by "Eli Collins (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/HADOOP-7085?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Eli Collins updated HADOOP-7085:
--------------------------------
Labels: newbie (was: )
> Documentation uses urls with "current"
> --------------------------------------
>
> Key: HADOOP-7085
> URL: https://issues.apache.org/jira/browse/HADOOP-7085
> Project: Hadoop Common
> Issue Type: Bug
> Components: documentation
> Reporter: Eli Collins
> Priority: Minor
> Labels: newbie
>
> The mapred and hdfs default links on the following page are broken. Looking into the cause, the links always point to the current docs so old generated docs have the wrong pointers (they should point to docs/<release> instead of docs/current). This is because cluster_setup.xml uses site.xml which defines references to the docs using http://hadoop.apache.org/core/docs/current.
> http://hadoop.apache.org/common/docs/r0.20.2/cluster_setup.html
--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira