I teach a class on computer graphics, where I want to embed my working source code into my web based explanations, so perhaps the following could help you
I have my source code in one directory, and in another I use Sphinx to make the documentation. In the documentation, I reference certain sections of code, which you can do by line number, or you can do by some pattern to begin and end.
Since I control all my source code, I put in comments with certain flags for regions of code.
I can then reference said section of code as follows
For your purposes, using a third party's code, I would make a new git repository, and copy the current status of their code in, I would then annotate the sections that I want to with comments, And then generate the documentation using Sphinx, referencing you annotations of their code
I tried building it from source a year ago on multiple tagged releases and it failed to build. Been using minidlna instead, which I’ve been pleased with.
I love Lineage and used it as my main phone OS but since my carrier required in February for VoLTE to work, I can’t receive or make phone calls anymore.
I remember while learning Smalltalk how surprised I was when if statements and loops weren’t syntax of the language, but methods on objects. True and False are singletons of a Boolean class, which has a method ifTrue:ifFalse which take lambdas as arguments. For loops, a lambda which returns True or False has a method whileTrue: which takes a lambda as an argument.
Although I like Python, and I don’t know JS well, I really enjoyed learning Smalltalk, even though I will likely never use it professionally.
> Now, free software advocates – and free culture advocates – hate the term “intellectual property.” The argument against IP rails against its imprecision and its rhetorical dishonesty.
-ANSI Common Lisp by Paul Graham
-On Lisp by Paul Graham
-Simply Scheme
-The Little Schemer
-Structure And Interpretation Of Computer Programs
-Paradigms of Artificial Intelligence Programming
Implementations
Common Lisp - any should be fine, I’ve used sbcl and clisp
Scheme - I like gambit scheme. It has a macro system that can be used like described in “On Lisp”
Regarding building from source, ~8 years ago, I built Mono, Monodevelop and their dependecies from source on Linux, no binaries, and it was straightforward. Created a language plug-in for a custom language, and I loved the dev environment. Shout out to the Mono community! (And thank you!)
Unfortunately, today, I can't figure out how to build that stack from source, even Gentoo's dotnet overlay can't seem to build it. Oh well. I'd appreciate any pointers.
I have my source code in one directory, and in another I use Sphinx to make the documentation. In the documentation, I reference certain sections of code, which you can do by line number, or you can do by some pattern to begin and end.
Since I control all my source code, I put in comments with certain flags for regions of code.
I can then reference said section of code as follows
https://github.com/billsix/modelviewprojection/blob/master/b...
The generated book is here https://billsix.github.io/modelviewprojection/
For your purposes, using a third party's code, I would make a new git repository, and copy the current status of their code in, I would then annotate the sections that I want to with comments, And then generate the documentation using Sphinx, referencing you annotations of their code