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): - 1.9.3 (22/Sep/09)

Reporter: Marcin Orlowski (borszczuk) Assignee: Satoru Yoshida (satoruyoshida) Tags: - Zend_Controller

Related issues: - ZF-7757



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.

<pre class="highlight">

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

<pre class="highlight">
Zend_Controller_Router_Route_ChainDefault Routes

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

Similar problem example:

<pre class="highlight">

in line 198, Zend_Db_Table_Rowset.xml

But there is also no problem link.

<pre class="highlight">

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:

<pre class="highlight">
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 :

<pre class="highlight">

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 :-(

Have you found an issue?

See the Overview section for more details.


© 2006-2016 by Zend, a Rogue Wave Company. Made with by awesome contributors.

This website is built using zend-expressive and it runs on PHP 7.