{"action":"closed","issue":{"url":"https://api.github.com/repos/doxygen/doxygen/issues/841","repository_url":"https://api.github.com/repos/doxygen/doxygen","labels_url":"https://api.github.com/repos/doxygen/doxygen/issues/841/labels{/name}","comments_url":"https://api.github.com/repos/doxygen/doxygen/issues/841/comments","events_url":"https://api.github.com/repos/doxygen/doxygen/issues/841/events","html_url":"https://github.com/doxygen/doxygen/issues/841","id":337294417,"node_id":"MDU6SXNzdWUzMzcyOTQ0MTc=","number":841,"title":"broken example links for functions in a group (Origin: bugzilla #123772)","user":{"login":"doxygen","id":1300762,"node_id":"MDQ6VXNlcjEzMDA3NjI=","avatar_url":"https://avatars3.githubusercontent.com/u/1300762?v=4","gravatar_id":"","url":"https://api.github.com/users/doxygen","html_url":"https://github.com/doxygen","followers_url":"https://api.github.com/users/doxygen/followers","following_url":"https://api.github.com/users/doxygen/following{/other_user}","gists_url":"https://api.github.com/users/doxygen/gists{/gist_id}","starred_url":"https://api.github.com/users/doxygen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/doxygen/subscriptions","organizations_url":"https://api.github.com/users/doxygen/orgs","repos_url":"https://api.github.com/users/doxygen/repos","events_url":"https://api.github.com/users/doxygen/events{/privacy}","received_events_url":"https://api.github.com/users/doxygen/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-07-01T14:17:47Z","updated_at":"2018-07-01T14:17:47Z","closed_at":"2018-07-01T14:17:47Z","author_association":"OWNER","body":"status RESOLVED severity *normal* in component *general* for *---*\nReported in version *1.3.x* on platform *Other*\nAssigned to: Dimitri van Heesch\n\nOn 2003-10-03 15:48:03 +0000, mike@ecommerce.com wrote:\n\n> I am trying to document a PHP function library, and i have grouped my \n> functions into categories using the \\addtogroup tag. But when using the \n> \\example tag to generate an example for a function that is in such a \n> group, it will display the example link in the documentation, but the file \n> it links to is not there. When i move the function outside of any group, \n> the example link works. \n>  \n> The link itself is correct, but no \"*-example.html\" pages are generated \n> for those examples. \n>  \n> I tested it with the windows binaries on a Windows XP system and on SuSE \n> Linux 8.2 with doxygen compiled from the prestine 1.3.4, 1.3.3 sources. It \n> works in 1.3.2. I use only the generated HTML documention, so i do not \n> know if the problem affects manpages, LaTeX, ... \n>  \n> Here is the shortest PHP script i could make up to demonstrate the \n> problem: \n>  \n> test.php: \n> <?php \n> /*! @defgroup grp_foo Example Group \n>  *  @{ \n>  */ \n>  \n> /*! \\brief Test function for the example tag \n>  * \n>  * This test function should demonstrate that the example link is broken \n>  * in the documentation \n>  */ \n> function foo() \n> { \n> } \n> /*! \n>  * \\example foo_example.php \n>  * This is an example of how to use the foo function. \n>  */ \n>  \n> /*! @} */ // end of grp_foo \n>  \n> /*! \\brief Second test function for the example tag \n>  * \n>  * This test function should demonstrate that the example of this \n>  * function is not broken in the documentation \n>  */ \n> function foo2() \n> { \n> } \n> /*! \n>  * \\example foo2_example.php \n>  * This is an example of how to use the foo2 function. \n>  */ \n> ?> \n>  \n> foo_example.php: \n> <?php \n> foo(); \n> ?> \n>  \n> foo2_example.php: \n> <?php \n> foo(); \n> ?> \n>  \n> The doxygen configuration settings to document the example are the \n> standard settings doxywizard suggest, plus EXTRACT_ALL enabled, plus the \n> file added in the input list of files and the directory with the example \n> added to the example directory list. \n>  \n> There is another thing that is related: I do not know if it is a bug or \n> intended behaviour, but in the generated HTML documentation, on the page \n> that lists all examples, the links to the examples behave differently, \n> depending whether they document a function that is grouped with \n> \\addtogroup or not. If the function the example is for is not grouped, it \n> goes directly to the page with the example. But if the function the \n> example is for is grouped, the link goes to the page that documents the \n> group. There, i have to search the function and have to follow the example \n> link below the function documentation to get to the example. \n> This is also something that changed. All links are directly pointing to \n> the example pages when generating with doxygen 1.3.2 and changed to the \n> above described behaviour since 1.3.3.\n\nOn 2004-08-12 22:00:14 +0000, Dimitri van Heesch wrote:\n\n> Should be fixed in the next CVS update (and eventually in 1.3.9).\n\nOn 2004-10-05 18:36:55 +0000, Dimitri van Heesch wrote:\n\n> Resolving because of 1.3.9 release\n\n"}}
{"actor":{"display_login":"doxygen"}}