first of all, thank you so much for creating this product, it helped me a lot understand SAS and what it can do.
I have a question about the documentation tool: I see that you sort of created your own implementation of doxygen in SAS to create the reports.
I think this is a very good idea and I would like to use this implementation as a standalone tool to document my code. I would like to have a little more detail: which part of the code deals with the documentation? How can I use it?
Thank you,
Marcello Barisonzi
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
the entry point for the documentation is _report_pgm_doc.sas. It creates formats for displying different langauges and sorting the tags in the documentation.
It loops over all programs (examinees) and collects the the header information (_scanheader.sas).
Afterwards is a little update dealing with ODS inline formating, that should not be evaluated in source code documentation.
Then _reportpgmheader prints the header part of the documentation and finally the source code is printed with PROC PRINT.
_reportpgmdoc.sas assumes the given SASUnit architecture. But with above hints you should be able to extract the necessary part from _reportpgmdoc.sas and add it into the loop over you own programs.
Best idea would be to have some unit tests for your programs executed with SASUnit and get the documentation for free. :)
Regards
Klaus Landwich
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Anonymous
Anonymous
-
2019-02-28
Thank you for your hints!
M.B.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Anonymous
Anonymous
-
2019-03-14
Hi,
I was able to quickly work something out, it's a testament on how good you write your code!
Would you be interested in adding Italian to the nls.txt file? I could help.
Regards,
Marcello Barisonzi
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Hi,
first of all, thank you so much for creating this product, it helped me a lot understand SAS and what it can do.
I have a question about the documentation tool: I see that you sort of created your own implementation of doxygen in SAS to create the reports.
I think this is a very good idea and I would like to use this implementation as a standalone tool to document my code. I would like to have a little more detail: which part of the code deals with the documentation? How can I use it?
Thank you,
Marcello Barisonzi
Hi Marcello Barisonzi,
the entry point for the documentation is _report_pgm_doc.sas. It creates formats for displying different langauges and sorting the tags in the documentation.
It loops over all programs (examinees) and collects the the header information (_scanheader.sas).
Afterwards is a little update dealing with ODS inline formating, that should not be evaluated in source code documentation.
Then _reportpgmheader prints the header part of the documentation and finally the source code is printed with PROC PRINT.
_reportpgmdoc.sas assumes the given SASUnit architecture. But with above hints you should be able to extract the necessary part from _reportpgmdoc.sas and add it into the loop over you own programs.
Best idea would be to have some unit tests for your programs executed with SASUnit and get the documentation for free. :)
Regards
Klaus Landwich
Thank you for your hints!
M.B.
Hi,
I was able to quickly work something out, it's a testament on how good you write your code!
Would you be interested in adding Italian to the nls.txt file? I could help.
Regards,
Marcello Barisonzi
Hi Marcello,
I would appreciate to have an additional language supported by SASUnit.
Just update nls.txt.
Regards
Klaus
Ok I have started. I will let you know when I am done.