ZF-7829: Documentation crosslinks are shown as ??? instead of correct name

Issue Type:

Docs: Problem

Created:

2009-09-11T08:57:07.000+0000

Last Updated:

2009-11-01T04:07:01.000+0000

Status:

Resolved

Fix version(s):

Reporter:

Marcin Orlowski (borszczuk)

Assignee:

Satoru Yoshida (satoruyoshida)

Tags:

Related issues:

Attachments:

Documentation crosslinks are shown as "???" instead of correct name. It looks like global issue but the living example can be found here:

where we read:

Rewrite Router comes with six basic types of routes (one of which is special):

*  ???
*  ???
*  ???
*  ???
*  ???

where ??? are links and supposed to be correctly named after target

Posted by Satoru Yoshida (satoruyoshida) on 2009-09-11T17:25:32.000+0000

now , I find the link tags without content as following.

If it would not be build error, but need content, controller class names (or Default Routes) may be needed.


Zend_Controller_Router_Route_ChainDefault Routes

Posted by Satoru Yoshida (satoruyoshida) on 2009-09-15T07:09:14.000+0000

Similar problem example:

in line 198, Zend_Db_Table_Rowset.xml

But there is also no problem link.

in line 32, Zend_Date-Overview.xml.

Posted by Satoru Yoshida (satoruyoshida) on 2009-09-15T23:32:04.000+0000

It seems to be better to change tag from link to xref because of explanation in ref/documentation-standard.xml .

Posted by Matthew Weier O'Phinney (matthew) on 2009-09-16T05:10:40.000+0000

Using the element is fine... as long as text is provided:


Zend_Date formats

If none is provided, however, it should be changed to , as that will inject the title of that section for the link.

Posted by Satoru Yoshida (satoruyoshida) on 2009-09-16T08:37:46.000+0000

Thank you for commentary, Matthew. I change 7 tags from link to xref. I searched with following regular expression :

Posted by Satoru Yoshida (satoruyoshida) on 2009-09-16T15:34:35.000+0000

And fixed similar problem in Zend_Date-Constants.xml Zend_Db_Table_Row.xml Zend_Db_Table_Rowset.xml at SVN r18151

Posted by Satoru Yoshida (satoruyoshida) on 2009-11-01T04:07:01.000+0000

I had solved this problem at 1.9.3 once.

Why same problem happend? I feel some strangeness :-(