Comments (8)
Fixed not yet released.
If no \brief
, the algorithm will try to use the the first paragraph or the first Return
section. For example, a Parameters
section or a Warning
section will be skipped.
As described, the result in your case will be "Returns: A value..."
from docsforge.
If you find a consistent behavior, please create a separate issue and report it :)
from docsforge.
It's by design.
Docsforge always tries to get a brief description. It uses the same concept as java and other languages do on their api docs - the first row should always be the brief description. There's no brief vs detailed description. Only if you use doxygen's \brief
command docsforge will use it and not extract the first row of the detailed description.
So in your case, max()
had no brief description, only detailed description with return paragraph and it was used as a brief description for the class page.
I think that if you look at max()
, min()
and next()
, having any description is better for the naive user than leaving it blank.
from docsforge.
Aha. I see that Doxygen does extract the docs for operator ()()
, though. Perhaps it does so only when no special command, such as \return
is used? My problem with the DocsForge output is not that it contains some description but the fact that it replaces "\return" with "Return" and leaves the rest intact; so you get something like "Return A value...", which is wrong both in grammar and capitalization. Is there something I or you can do to avoid this, other than adding \brief
descriptions or avoiding \return
?
from docsforge.
You should definitely keep using \return
and not be forced to use \brief
. Moreover, docsforge does it automatically for any \par
. docsforge should fix this.
The problem is the capitalization - I don't want to turn the first letter to lower case because it's error prone - acronyms or even if first word is a parameter or class name that begins with a capital case.
what about adding a colon? changing "Return" -> "Return:"
I'm also fine with changing all of doxygen's special paragraphs to plural form.
I think "Returns: A value..." looks great.
Are you good with this solution?
from docsforge.
Great, thanks!
from docsforge.
Released version 3.4.21, check https://breeze.docsforge.com/master/api/breeze/entropy_source/
from docsforge.
from docsforge.
Related Issues (20)
- Variables added from the README documentation HOT 2
- Macros in code are causing parser errors. HOT 6
- Public Api sidebar is not displayed correctly HOT 2
- Download configuration file isn't working HOT 2
- Allow displaying doxygen's html output. HOT 2
- Add Algolia as search provider HOT 6
- Broken link in Home / Versions HOT 3
- Inconsistent punctuation in member function descriptions, and expressions like "i.e." or "e.g." HOT 3
- Missing documentation for two stream inserters
- Request: showing parameter list and return type in function descriptions HOT 5
- Thoughts about using docsforge with existing readthedocs / sphinx documentation HOT 1
- Request: adding EXTRACT_PRIV_VIRTUAL
- Related global functions shown as methods HOT 1
- Public class members other than member functions not shown
- Two enum-related problems
- "Global" language pill switching
- Suppress link generation for commonly used words
- Error generating automatic API documentation when input folder has same name as project
- ERROR!! Your sidebar section Public API has 0 pages HOT 2
- 错误,网站打不开了? HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docsforge.