I never knew how to use the 3rdparty stuff because of the lack of information, so I documented the fantom frameworks in the "normal" way. To create all the cerberusdoc files, I use a self written tool so I can create the descriptions inside the source code. this way a new function /method was still listed no matter if I added a description or not.How many documented 3rd party frameworks are out there? Is it just Ignition X and Pyro? Because yet those two are documented very differently and it seems to me, the way 3rd party docs should be written and organized was never clearly documented and instead, if you wanted to provide a 3rd party doc, you had to trial-and-error your way to an acceptable result. Maybe the "3rd party doccer" just never worked perfectly and instead people had to workaround the doccers capabilities. Is anyone from back then still here? Can someone confirm? Am I overlooking something?
I never knew how to use the 3rdparty stuff because of the lack of information
Thanks for confirming my fears. I thought this might be the case, but I was also worried I simply misunderstood how it's supposed to work.I discovered that it didn't work like it should
However, I've nowhere seen this feature being used, therefore I don't know exactly how it's supposed to work (should that _example.cxs simply be copied to docs/html/examples and is it then linked in the doc page?). And maybe that's also the reason I can't get it to work with the existing Makedocs tool. Has it ever been implemented? Did anyone ever use it? Because if not, I consider not implementing it: There's already a perfectly fine way to provide samples for your documentation (two, if you consider it's also possible putting .cxs files in the .data directory and then linking to them using a relative file system path).In addition, you can add example programs in Cerberus X source code form to an 'examples' directory located in the same directory as the .cxs or .cerberusdoc file the docs are located in.
Such example programs should have the same name as the declaration they are providing an example for, with an '_example' suffix. For example, example code for the above function would be named 'Frobozz_example.cxs'.
Don't remove it!Has it ever been implemented? Did anyone ever use it?