Re: software to document and develop projects

2025-02-11 Thread Max Nikulin

On 08/02/2025 22:13, Michel Verdier wrote:


Emacs org mode can handle mixed code / documentation


Specifically for octave some examples are provided in
https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-octave.html
(use the .org suffix to get the source file).

Using "bare" engine prompt is not the most convenient way in all cases. 
You may try various front-ends. E.g. for "maxima" there is wxmaxima 
(unlike octave, it is mostly for symbolic computations).




Re: software to document and develop projects

2025-02-11 Thread Gary L. Roach


On 2/7/25 17:28, Gary L. Roach wrote:


I have been trying  to find a software package that would allow me to 
do math calculations along with running documentation.I have tried 
using -Octave but it doesn't allow modification of content once you 
hit the enter key. After a few mistakes and corrections things get so 
messy that content is unreadable. I need something that will allow 
corrections to be made.in both the math and text. Anyone have a 
suggestion.



Gary R

After I tried jupyter notebook and being confronted with  another 
f***ing learning experience: I decided to go back to my old standby 
spread sheet program (librecalc). It is a bit short on the documentation 
end but gets the job done. I just don't have time or the inclination to 
learn a new package. Thanks to all for your inputs.


Gary R


Re: software to document and develop projects

2025-02-08 Thread Nicholas Geovanis
On Sat, Feb 8, 2025, 7:52 AM  wrote:

> "Gary L. Roach"  wrote:
> > I have been trying  to find a software package that would allow me to
> > do math calculations along with running documentation.I have tried
> > using -Octave but it doesn't allow modification of content once you
> > hit the enter key. After a few mistakes and corrections things get so
> > messy that content is unreadable. I need something that will allow
> > corrections to be made.in both the math and text. Anyone have a
> > suggestion.
>

You forgot to read this section of the doc:

https://docs.octave.org/latest/Executable-Octave-Programs.html

You just put the octave code in a file and execute that file. You can do
that from inside octave too.

There's a wikipedia article
> https://en.wikipedia.org/wiki/List_of_open-source_software_for_mathematics
> that might provide some possibilities.
>
>


Re: software to document and develop projects

2025-02-08 Thread Michel Verdier
On 2025-02-07, Van Snyder wrote:

> I wrote a simple processor that looks for comments that begin !{ in my
> Fortran codes and writes a LaTeX file, which I then process into PDF.
> Lets me see gorgeously LaTeX typeset math beside my code.

Emacs org mode can handle mixed code / documentation



Re: software to document and develop projects

2025-02-08 Thread debian-user
"Gary L. Roach"  wrote:
> I have been trying  to find a software package that would allow me to
> do math calculations along with running documentation.I have tried
> using -Octave but it doesn't allow modification of content once you
> hit the enter key. After a few mistakes and corrections things get so
> messy that content is unreadable. I need something that will allow
> corrections to be made.in both the math and text. Anyone have a
> suggestion.

There's a wikipedia article
https://en.wikipedia.org/wiki/List_of_open-source_software_for_mathematics
that might provide some possibilities.



Re: software to document and develop projects

2025-02-08 Thread Richard Owlett

On 2/8/25 12:56 AM, Geert Stappers wrote:

On Fri, Feb 07, 2025 at 05:28:43PM -0800, Gary L. Roach wrote:

I have been trying  to find a software package that would allow me to do
math calculations along with running documentation.I have tried using
-Octave but it doesn't allow modification of content once you hit the enter
key. After a few mistakes and corrections things get so messy that content
is unreadable. I need something that will allow corrections to be made.in
both the math and text. Anyone have a suggestion.


Despite not completely understanding the need, I suggest
https://en.wikipedia.org/wiki/Project_Jupyter#Jupyter_Notebook



I looked at that link and https://jupyter.org/ . I don't know if it 
meets the OP's needs but I may find it useful. Will read more fully 
after a good night's sleep.


Is there a relevant traditional mailing list or USENET group?
[ I *avoid* social networks, WEB based forums, Google groups, etc ]





Re: software to document and develop projects

2025-02-07 Thread Geert Stappers
On Fri, Feb 07, 2025 at 05:28:43PM -0800, Gary L. Roach wrote:
> I have been trying  to find a software package that would allow me to do
> math calculations along with running documentation.I have tried using
> -Octave but it doesn't allow modification of content once you hit the enter
> key. After a few mistakes and corrections things get so messy that content
> is unreadable. I need something that will allow corrections to be made.in
> both the math and text. Anyone have a suggestion.

Despite not completely understanding the need, I suggest
https://en.wikipedia.org/wiki/Project_Jupyter#Jupyter_Notebook


Groeten
Geert Stappers
-- 
Silence is hard to parse



Re: software to document and develop projects

2025-02-07 Thread Van Snyder
On Fri, 2025-02-07 at 17:28 -0800, Gary L. Roach wrote:
> I have been trying  to find a software package that would allow me to
> do math calculations along with running documentation.I have tried
> using -Octave but it doesn't allow modification of content once you
> hit the enter key. After a few mistakes and corrections things get so
> messy that content is unreadable. I need something that will allow
> corrections to be made.in both the math and text. Anyone have a
> suggestion.

Maple does that well, but it's expensive for a permanent license. They
offer an evaluation license.

I wrote a simple processor that looks for comments that begin !{ in my
Fortran codes and writes a LaTeX file, which I then process into PDF.
Lets me see gorgeously LaTeX typeset math beside my code.

> 
> Gary R
>