einpoklum
2017-03-29 20:56:59 UTC
Jeg har brug for at generere dokumentation til et C ++ - projekt af mig (og snart måske også til yderligere). Indtil videre har jeg undersøgt doxygen, og selvom det ser ud til at være populært, har jeg haft nogle problemer med det (detaljerne som jeg ikke vil gå ind på her; nogle er løst). Da jeg ikke er særlig knyttet til det - på trods af dets tilsyneladende popularitet - vil jeg overveje nogle alternativer.
Nu for 7 år siden var der et spørgsmål om StackOverflow om netop det:
men svarene er nu dateret, så jeg stiller det samme spørgsmål her og nu.
Krav:
- Libre
- Gratis
- Multiplatform, der understøtter mindst Linux og Windows
- Fleksibel til et lignende niveau som doxygen eller mere
- Aktivt vedligeholdt
- Ikke-ubetydelig brugerbase
Hvis du "ikke går ind på detaljerne her", bliver det svært at hjælpe dig
@Mawg: Det var for det meste [dette] (http://stackoverflow.com/q/43093051/1593077), men det hjælper dig ikke meget tror jeg ...
Men det blev løst. Så hvorfor ikke bruge DoxyGen? Bare nysgerrig
@Mawg: Det faktum, at det opførte sig sådan, gav mig en fornemmelse om, at jeg måske vil have noget andet. Også, hvorfor _skal_ jeg bruge doxygen, bortset fra jeg har hørt om det? Det er ikke som en jeg har positiv erfaring med det.
Hvorfor ikke i det mindste prøve det? Der er mange mennesker derude, der er positive over for det. De kan ikke alle tage fejl. Plus, det er blevet aktivt vedligeholdt og udviklet i mange tårer, og Dimitri er meget nyttigt Da hjemmesiden starter "Doxygen er de facto standardværktøjet til at generere dokumentation fra kommenterede C ++ - kilder", er det helt sikkert værd at prøve. Og at det fortsætter “men det understøtter også andre populære programmeringssprog er et stort plus for mig.
Men vent, du havde et problem, som blev løst, så du har sandsynligvis * brugt * det til at generere dokumentation fra din kode. Hvis du kan fortælle os, hvilke specifikke funktioner der mangler, kan vi prøve at hjælpe dig.
@Mawg: Hvem sagde, at jeg ikke prøver det? Jeg vil bare ikke prøve _only_ doxygen.
Så prøv andre *** og *** DoxyGen (hvis det hjælper, er der sandsynligvis en grund til, at det er industristandarden)
Da det eneste hidtil eneste foreslåede alternativ er Sphinx-Doc, skal du kigge på [Hvad er de største forskelle mellem Sphinx og Doxygen?] (Https://stackoverflow.com/questions/31571849/what-are-the-main-differences -of-sfinks og doxygen) og Wikipedia's [Sammenligning af dokumentationsgeneratorer] (https://en.wikipedia.org/wiki/Comparison_of_documentation_generators)
stackoverflow.com-linket ... returnerer nu "siden blev ikke fundet". administratorer går lidt ud af hånden der.
@TrevorBoydSmith: Spørgsmålet blev slettet, men admis / moderatorer der burde have flyttet svarene her. Måske kan vi gøre det?
@TrevorBoydSmith: Se mit nye svar ...
hvad er der med alle de ubrugelige kommentarer om at fortælle ham at bruge doxygen, når han sagde, at han ønskede alternativer? +1 for endnu en ubrugelig kommentar. Tak for at stille spørgsmålet og wtf slettede de det andet spørgsmål til