Nasal api doc.py

From FlightGear wiki
Revision as of 09:28, 25 March 2020 by Johan G (talk | contribs) (Partial copy editing; +-cat: Python Software → Python software)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
This article is a stub. You can help the wiki by expanding it.

There is a Python script that parses $FG_ROOT/Nasal to create up-to-date Nasal docs from it. See Adrian's script: viewtopic.php?f=72&t=25119[1]

There is a dedicated Python script that can help automatically extract most of the boilerplate structure to help create the wiki stub. See Adrian's work.[2]


Adrian came up with a simple Nasal API file for $FG_ROOT/Nasal using a python script. He uploaded the file here. Adrian's python script automatically creates Nasal API docs based on parsing $FG_ROOT/Nasal.[3]


Adrian's nasal_api_doc.py script in $FG_SRC/scripts/python should automatically create updated API documentation based on the nasal source code in $FG_ROOT/Nasal (HTML output).[4]


This is a temporary solution until there is a more solid solution. The reasons Adrian used a home made parser instead of a pre-made solution is the lack of uniform coding and comment style. There is for sure a lot to be improved. For one, Adrian would like to extend it further so it can parse classes as well.

Please take a look and comment.[5]

References

References
  1. Hooray  (May 21st, 2016).  Re: .
  2. Hooray  (Jan 25th, 2017).  Re: Canvas GUI API documentation in wiki .
  3. Hooray  (Feb 11th, 2012).  Re: .
  4. Hooray  (Feb 15th, 2013).  Re: Canvas API documentation .
  5. adrian  (Jan 27th, 2012).  .