Pioneer dev forum

Posted: **Tue Mar 14, 2023 9:18 pm**

Building the LUA documentation locally is pretty simple. In case you want to use the (currently unsupported) NaturalDocs v2.x in Linux:

install mono ("mono-devel" package for openSUSE)
download NaturalDocs from https://naturaldocs.org/download/ and extract
create the following folders (or any others where the documentation and the NaturalDocs project files should go):
- /path_to_your_pioneer_folder/naturaldocs
- /path_to_your_pioneer_folder/naturaldocs/docs
run from command line:

Code: Select all

mono NaturalDocs.exe -i /path_to_your_pioneer_folder -o HTML /path_to_your_pioneer_folder/naturaldocs/docs -p /path_to_your_pioneer_folder/naturaldocs

edit:
Standard NaturalDocs does not recognize the "Attribute" keyword used in the pioneer lua files. To include documented attributes/variables in the local lua reference you need to edit (or place a new) Comments.txt into the project folder (/path_to_your_pioneer_folder/naturaldocs) that includes:

Code: Select all

Code: Select all

Alter Comment Type: Variable

   Keywords:
      Attribute
      Attributes

Posted: **Wed Mar 15, 2023 3:05 am**

Thanks! This may be useful for me to build the documentation into an rpm package for Alt Linux. It is a pity that naturaldocs is not very common (especially version 2.x). Apparently no one really wants to have mono in build dependencies.

Posted: **Wed Mar 15, 2023 9:25 am**

Code: Select all

<sturnclaw> NaturalDocs 2.0 is the version we will support moving forwards -
            it works fine, just needs a build script/CMake target and
            associated CI workflow to build and publish [04:30:54]

So, we just need to update above, and COMPILING.txt, if anyone is feeling up to it.

(Doing the CI workflow falls on my table, I guess. I'll see if I can see how it currently (doesn't) work).

Posted: **Thu Mar 16, 2023 12:01 am**

script/CMake is a bit out of my comfort zone...

Posted: **Thu Mar 16, 2023 7:38 am**

I'll see if I can harass someone to fix the CMake for us.

Posted: **Sat Mar 25, 2023 4:12 pm**

Well, turns something came out of this Saturday's 'knoting' (Norwegian word, roughly: tinkering)
https://github.com/pioneerspacesim/pioneer/pull/5575

Posted: **Mon May 08, 2023 12:43 pm**

For completeness, this issue is solved, we now have auto-generated code documentation that will always be up-to-date with master:
https://codedoc.pioneerspacesim.net/

If anyone have Natural Docs config suggestions, please let us know.

Pioneer dev forum

Building LUA documentation using NaturalDocs 2.x (Linux)

Building LUA documentation using NaturalDocs 2.x (Linux)

Re: Building LUA documentation using NaturalDocs 2.x (Linux)

Re: Building LUA documentation using NaturalDocs 2.x (Linux)

Re: Building LUA documentation using NaturalDocs 2.x (Linux)

Re: Building LUA documentation using NaturalDocs 2.x (Linux)

Re: Building LUA documentation using NaturalDocs 2.x (Linux)

Re: Building LUA documentation using NaturalDocs 2.x (Linux)