Documenting input and output file formats
Rob McDonald <[email protected]> Mon, 1 May 2023 14:27:07 -0700
| Newsgroups | gmane.text.doxygen.general |
|---|---|
| Message-ID | <CAEppYpGKvrjt+Y2yu+X6WgGdCFkevx+orc0OmswWroDyfgs8WQ@mail.gmail.com> |
--===============8363148874060641808== Content-Type: multipart/alternative; boundary="000000000000c772a305faa87ce5" --000000000000c772a305faa87ce5 Content-Type: text/plain; charset="UTF-8" Has anyone used Doxygen to generate documentation for input and /or output file formats? I'm working in the paradigm of a command line program that has a few plain-text files as input -- and a bunch of other plain-text files as output. I'm looking for a means of annotating file read statements (fscanf, fread, whatever) in the source code. Then, upon running Doxygen (or another tool) and providing a pointer to an example file, some form of input file documentation is generated. If anyone has used Doxygen for this kind of thing, links to a GitHub repo showing techniques and best practices would be appreciated. Thanks for any suggestions. Rob --000000000000c772a305faa87ce5 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable <div dir=3D"ltr">Has anyone used Doxygen to generate documentation for inpu= t and /or output file formats?<div><br></div><div>I'm working in the pa= radigm=C2=A0of a command=C2=A0line program that has a few plain-text files = as input -- and a bunch of other plain-text files as output.</div><div><br>= </div><div>I'm looking for a means of annotating file read statements (= fscanf, fread, whatever) in the source code. Then,=C2=A0 upon running=C2=A0= Doxygen (or another tool) and providing a pointer to an example file, some = form of input file documentation is generated.</div><div><br></div><div>If = anyone has used Doxygen for this kind of thing, links to a GitHub repo show= ing techniques and best practices would be appreciated.</div><div><br></div= ><div>Thanks for any suggestions.</div><div><br></div><div>Rob</div></div> --000000000000c772a305faa87ce5-- --===============8363148874060641808== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline --===============8363148874060641808== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Doxygen-users mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/doxygen-users --===============8363148874060641808==--