O.k., getting somewhere...tried different combinations and permutations and I am now able to process entire files at a time.
It turns out that the directives are not really interchangeable. For the *main* program, i.e., the one that has the program pname procedure in it, one *must* use the .. f:autoprogram:: pname directive. Nothing else works; not even attempting .. f:autosrcfile:: pname.f90 works for this particular file. For source files containing *modules*, one *must* use the .. f:automodule:: modname directive; and *modname* needs to be all lower case even if written in upper- or camel-case in the Fortran files. No point on using the .. f:autosrcfile:: modname.f90 with this file, it does not work. "Regular" Fortran source files, i.e., not containing the main procedure or modules but just other functions and subroutine can be auto-documented with the src directive .. f:autosrcfile:: filename.f90 Variables are being picked up but their in-line descriptions are not being brought over. Would like to get this working. On Thu, Dec 18, 2014 at 9:41 PM, German Salazar <[email protected]> wrote: > > By the way, the link above to the sphinxfortran extension is labeled as > being version 0.2...but the actual file downloaded ended up being version > 0.1...is that o.k.? > > O.k., as only did as indicated in the README file and added just one line > to the create index.rst file: > > Contents: > > .. toctree:: > :maxdepth: 3 > > .. f:automodule:: gasprop > > I get the following messages during make html: > > loading translations [fortran]... not available for built-in messages > > and later on: > > reading sources... [100%] index > > Exception occurred: > File > "/home/salazag/local/programs/anaconda/lib/python2.7/site-packages/sphinxfortran/fortran_domain.py", > line 263, in scan_fieldarg > raise ValueError('Wrong field (%s). It must have at least one > parameter name and one argument'%fieldname) > ValueError: Wrong field (). It must have at least one parameter name and > one argument > The full traceback has been saved in /tmp/sphinx-err-E3hM6g.log, if you > want to report the issue to the developers. > Please also report this if it was a user error, so that a better error > message can be provided next time. > > > gsal > > > > -- > You received this message because you are subscribed to a topic in the > Google Groups "sphinx-users" group. > To unsubscribe from this topic, visit > https://groups.google.com/d/topic/sphinx-users/gQfMxDsXQo0/unsubscribe. > To unsubscribe from this group and all its topics, send an email to > [email protected]. > To post to this group, send email to [email protected]. > Visit this group at http://groups.google.com/group/sphinx-users. > For more options, visit https://groups.google.com/d/optout. > -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
