docs not building to PDF

2022-10-07 Thread Joel Sherrill 
Hi

I have been building the docs fairly regularly as part of pushing
patches but it is not building PDF on the master for me.

===
[62/62] Compiling build/filesystem/latex/filesystem.tex
first pass on pdflatex
11:48:31 runner ['/usr/local/texlive/2019/bin/x86_64-linux/pdflatex',
'-shell-escape', '-interaction=batchmode',
'/home/joel/rtems-work/rtems-docs/build/filesystem/latex/filesystem.tex']
This is pdfTeX, Version 3.14159265-2.6-1.40.20 (TeX Live 2019) (preloaded
format=pdflatex)
 \write18 enabled.
entering extended mode

Waf: Leaving directory `/home/joel/rtems-work/rtems-docs/build'
Build failed
Traceback (most recent call last):
  File
"/home/joel/rtems-work/rtems-docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Task.py",
line 180, in process
ret=self.run()
  File
"/home/joel/rtems-work/rtems-docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Tools/tex.py",
line 204, in run
self.call_latex()
  File
"/home/joel/rtems-work/rtems-docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Tools/tex.py",
line 234, in call_latex
self.check_status('error when calling latex',self.texfun())
  File
"/home/joel/rtems-work/rtems-docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Tools/tex.py",
line 119, in check_status
raise Errors.WafError('%r command exit status %r'%(msg,retcode))
waflib.Errors.WafError: 'error when calling latex' command exit status 1
===

Any suggestions? Does this happen to anyone else?

--joel
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-07 Thread Noor Aman 
I can confirm that the same is happening on my PC too.
===
$ uname -a

Linux lynx 5.15.72-1-lts #1 SMP Wed, 05 Oct 2022 12:15:15 + x86_64
GNU/Linux
$ pip list
Package   Version
- -
absl-py   1.2.0
alabaster 0.7.12
appdirs   1.4.4
astunparse1.6.3
autocommand   2.2.1
Babel 2.10.3
btrfsutil 5.19.1
build 0.8.0
cachetools5.2.0
chardet   5.0.0
Cython0.29.32
distro1.7.0
docutils  0.19
esbonio   0.14.1
flatbuffers   1.12
gast  0.4.0
google-auth   2.11.0
google-auth-oauthlib  0.4.6
google-pasta  0.2.0
h5py  3.7.0
idna  3.4
imagesize 1.4.1
importlib-metadata4.9.0
inflect   6.0.0
jaraco.context4.1.2
jaraco.functools  3.5.2
jaraco.text   3.9.1
Jinja23.1.2
keras 2.9.0
Keras-Preprocessing   1.1.2
latexcodec2.0.1
libclang  14.0.6
libfdt1.6.1
Mako  1.2.3
Markdown  3.4.1
MarkupSafe2.1.1
more-itertools8.13.0
numpy 1.23.2
opt-einsum3.3.0
ordered-set   4.1.0
packaging 21.3
pep5170.13.0
pip   22.2.2
pip-autoremove0.10.0
py-cpuinfo8.0.0
pyasn10.4.8
pyasn1-modules0.2.8
pybtex0.24.0
pybtex-docutils   1.0.2
pycairo   1.21.0
pydantic  1.9.2
pygls 0.12.1
Pygments  2.13.0
PyGObject 3.42.2
pyinotify 0.9.6
pyparsing 3.0.9
PyQt5 5.15.7
PyQt5-sip 12.11.0
PyQtWebEngine 5.15.6
pyspellchecker0.7.0
python-xlib   0.31
pytz  2022.1
PyYAML6.0
requests  2.28.1
requests-oauthlib 1.3.1
rsa   4.9
ruamel.yaml   0.17.21
ruamel.yaml.clib  0.2.6
setuptools63.1.0
six   1.16.0
smbus 1.1
snowballstemmer   2.2.0
Sphinx5.2.3
sphinxcontrib-applehelp   1.0.2
sphinxcontrib-bibtex  2.5.0
sphinxcontrib-devhelp 1.0.2
sphinxcontrib-htmlhelp2.0.0
sphinxcontrib-jsmath  1.0.1
sphinxcontrib-qthelp  1.0.3
sphinxcontrib-serializinghtml 1.1.5
system-monitoring-center  1.27.0
team  1.0
tensorboard   2.9.1
tensorboard-data-server   0.6.1
tensorboard-plugin-wit1.8.1
tensorflow-io-gcs-filesystem  0.26.0
termcolor 1.1.0
tomli 2.0.1
trove-classifiers 2022.9.26
typeguard 2.13.3
typing_extensions 4.3.0
urllib3   1.26.12

On Fri, 7 Oct 2022 at 22:50, Joel Sherrill  wrote:

> Hi
>
> I have been building the docs fairly regularly as part of pushing
> patches but it is not building PDF on the master for me.
>
> ===
> [62/62] Compiling build/filesystem/latex/filesystem.tex
> first pass on pdflatex
> 11:48:31 runner ['/usr/local/texlive/2019/bin/x86_64-linux/pdflatex',
> '-shell-escape', '-interaction=batchmode',
> '/home/joel/rtems-work/rtems-docs/build/filesystem/latex/filesystem.tex']
> This is pdfTeX, Version 3.14159265-2.6-1.40.20 (TeX Live 2019) (preloaded
> format=pdflatex)
>  \write18 enabled.
> entering extended mode
>
> Waf: Leaving directory `/home/joel/rtems-work/rtems-docs/build'
> Build failed
> Traceback (most recent call last):
>   File
> "/home/joel/rtems-work/rtems-docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Task.py",
> line 180, in process
> ret=self.run()
>   File
> "/home/joel/rtems-work/rtems-docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Tools/tex.py",
> line 204, in run
> self.call_latex()
>   File
> "/home/joel/rtems-work/rtems-docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Tools/tex.py",
> line 234, in call_latex
> self.check_status('error when calling latex',self.texfun())
>   File
> "/home/joel/rtems-work/rtems-docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Tools/tex.py",
> line 119, in check_status
>

Re: docs not building to PDF

2022-10-07 Thread Chris Johns 
On 8/10/2022 10:12 am, Noor Aman wrote:
> I can confirm that the same is happening on my PC too.

Could you please bisect the repo to find the patch that broke things?

Thanks
Chris
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-07 Thread Chris Johns 
On 8/10/2022 9:47 am, Chris Johns wrote:
> On 8/10/2022 10:12 am, Noor Aman wrote:
>> I can confirm that the same is happening on my PC too.
> 
> Could you please bisect the repo to find the patch that broke things?

A simpler way to find the commit is to see the last build on docs.rtems.org
which is 6.278550b and the next commit after 278550b is:

commit 23fc93bf648507ac417237c20069c4ab7c793251
Author: Frank Kühndel 
Date:   Thu Jun 9 15:21:05 2022 +0200

TFTPFS: New documentation

Frank ?

Chris
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-08 Thread Noor Aman 
Hey Frank,

I was able to find the issue which was causing the pdf to be not built
properly.
==
diff --git a/filesystem/trivial_ftp.rst b/filesystem/trivial_ftp.rst
index 3ef8bba..eccd035 100644
--- a/filesystem/trivial_ftp.rst
+++ b/filesystem/trivial_ftp.rst
@@ -280,10 +280,7 @@ application.  The mount point can be any directory.
The name ``/tftp``
 used in the figure serves only as an example.  The final unmounting and
 remove directory steps are optional.

-.. figure:: ../images/filesystem/tftpfs_usage.png
-  :width: 90%
-  :align: center
-  :alt: TFTP Usage Diagram
+
===
This png is causing issues. Removing these lines removed the error and the
pdf was generated successfully. I hope this is helpful.

Thanks,
Noor

On Sat, 8 Oct 2022 at 05:35, Chris Johns  wrote:

> On 8/10/2022 9:47 am, Chris Johns wrote:
> > On 8/10/2022 10:12 am, Noor Aman wrote:
> >> I can confirm that the same is happening on my PC too.
> >
> > Could you please bisect the repo to find the patch that broke things?
>
> A simpler way to find the commit is to see the last build on
> docs.rtems.org
> which is 6.278550b and the next commit after 278550b is:
>
> commit 23fc93bf648507ac417237c20069c4ab7c793251
> Author: Frank Kühndel 
> Date:   Thu Jun 9 15:21:05 2022 +0200
>
> TFTPFS: New documentation
>
> Frank ?
>
> Chris
> ___
> devel mailing list
> devel@rtems.org
> http://lists.rtems.org/mailman/listinfo/devel
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-08 Thread Joel Sherrill 
On Sat, Oct 8, 2022 at 7:24 AM Noor Aman  wrote:

> Hey Frank,
>
> I was able to find the issue which was causing the pdf to be not built
> properly.
> ==
> diff --git a/filesystem/trivial_ftp.rst b/filesystem/trivial_ftp.rst
> index 3ef8bba..eccd035 100644
> --- a/filesystem/trivial_ftp.rst
> +++ b/filesystem/trivial_ftp.rst
> @@ -280,10 +280,7 @@ application.  The mount point can be any directory.
> The name ``/tftp``
>  used in the figure serves only as an example.  The final unmounting and
>  remove directory steps are optional.
>
> -.. figure:: ../images/filesystem/tftpfs_usage.png
> -  :width: 90%
> -  :align: center
> -  :alt: TFTP Usage Diagram
> +
> ===
> This png is causing issues. Removing these lines removed the error and the
> pdf was generated successfully. I hope this is helpful.
>

Thanks. I saw this email right as I was setting up to do a git bisect with
my
morning tea.

Two issues with this figure situation.

(1) We probably should not have png/jpg files without the corresponding
source.

(2) I have no idea how to fix this other than to remove the figure. It
looks like Frank's
text is referencing the figure so simply removing it isn't the best answer.

--joel

>
> Thanks,
> Noor
>
> On Sat, 8 Oct 2022 at 05:35, Chris Johns  wrote:
>
>> On 8/10/2022 9:47 am, Chris Johns wrote:
>> > On 8/10/2022 10:12 am, Noor Aman wrote:
>> >> I can confirm that the same is happening on my PC too.
>> >
>> > Could you please bisect the repo to find the patch that broke things?
>>
>> A simpler way to find the commit is to see the last build on
>> docs.rtems.org
>> which is 6.278550b and the next commit after 278550b is:
>>
>> commit 23fc93bf648507ac417237c20069c4ab7c793251
>> Author: Frank Kühndel 
>> Date:   Thu Jun 9 15:21:05 2022 +0200
>>
>> TFTPFS: New documentation
>>
>> Frank ?
>>
>> Chris
>> ___
>> devel mailing list
>> devel@rtems.org
>> http://lists.rtems.org/mailman/listinfo/devel
>
> ___
> devel mailing list
> devel@rtems.org
> http://lists.rtems.org/mailman/listinfo/devel
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-08 Thread Noor Aman 
After further digging I found that this image 'tftpfs_usage.png' is
actually missing from the /images/filesystem directory. So just to confirm
this, I used a dummy 'tftpfs_usage.png', put that in the same directory and
everything built fine. So nothing needs to be removed. All we need is the
actual 'tftpfs_usage.png' image in the directory.

On Sat, 8 Oct 2022 at 20:00, Joel Sherrill  wrote:

>
>
> On Sat, Oct 8, 2022 at 7:24 AM Noor Aman  wrote:
>
>> Hey Frank,
>>
>> I was able to find the issue which was causing the pdf to be not built
>> properly.
>> ==
>> diff --git a/filesystem/trivial_ftp.rst b/filesystem/trivial_ftp.rst
>> index 3ef8bba..eccd035 100644
>> --- a/filesystem/trivial_ftp.rst
>> +++ b/filesystem/trivial_ftp.rst
>> @@ -280,10 +280,7 @@ application.  The mount point can be any directory.
>> The name ``/tftp``
>>  used in the figure serves only as an example.  The final unmounting and
>>  remove directory steps are optional.
>>
>> -.. figure:: ../images/filesystem/tftpfs_usage.png
>> -  :width: 90%
>> -  :align: center
>> -  :alt: TFTP Usage Diagram
>> +
>> ===
>> This png is causing issues. Removing these lines removed the error and
>> the pdf was generated successfully. I hope this is helpful.
>>
>
> Thanks. I saw this email right as I was setting up to do a git bisect with
> my
> morning tea.
>
> Two issues with this figure situation.
>
> (1) We probably should not have png/jpg files without the corresponding
> source.
>
> (2) I have no idea how to fix this other than to remove the figure. It
> looks like Frank's
> text is referencing the figure so simply removing it isn't the best answer.
>
> --joel
>
>>
>> Thanks,
>> Noor
>>
>> On Sat, 8 Oct 2022 at 05:35, Chris Johns  wrote:
>>
>>> On 8/10/2022 9:47 am, Chris Johns wrote:
>>> > On 8/10/2022 10:12 am, Noor Aman wrote:
>>> >> I can confirm that the same is happening on my PC too.
>>> >
>>> > Could you please bisect the repo to find the patch that broke things?
>>>
>>> A simpler way to find the commit is to see the last build on
>>> docs.rtems.org
>>> which is 6.278550b and the next commit after 278550b is:
>>>
>>> commit 23fc93bf648507ac417237c20069c4ab7c793251
>>> Author: Frank Kühndel 
>>> Date:   Thu Jun 9 15:21:05 2022 +0200
>>>
>>> TFTPFS: New documentation
>>>
>>> Frank ?
>>>
>>> Chris
>>> ___
>>> devel mailing list
>>> devel@rtems.org
>>> http://lists.rtems.org/mailman/listinfo/devel
>>
>> ___
>> devel mailing list
>> devel@rtems.org
>> http://lists.rtems.org/mailman/listinfo/devel
>
>
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-10 Thread Frank Kühndel 

Hello,

I am very sorry for having caused this trouble.

In my first email in June I wrote that there is an image which I did not 
send as part of the patch (who is reviewing some 160KiB binary PNG data 
and will the mailing list server accept that?). Yet, I forgot to mention 
these files in my last Email. I uploaded the two missing files to:


images/filesystem/tftpfs_usage.png:
https://share.embedded-brains.de/index.php/s/fQ4WrLrqmBjcbwC

images/filesystem/ftpfs_usage.svg:
https://share.embedded-brains.de/index.php/s/xk7kArkm6mbjcn2

The SVG file is the source for the PNG. Both files must be placed in the 
images/filesystem folder.


Again sorry for the trouble
Frank


On 10/8/22 22:17, Noor Aman wrote:

After further digging I found that this image 'tftpfs_usage.png' is
actually missing from the /images/filesystem directory. So just to confirm
this, I used a dummy 'tftpfs_usage.png', put that in the same directory and
everything built fine. So nothing needs to be removed. All we need is the
actual 'tftpfs_usage.png' image in the directory.

On Sat, 8 Oct 2022 at 20:00, Joel Sherrill  wrote:



On Sat, Oct 8, 2022 at 7:24 AM Noor Aman  wrote:


Hey Frank,

I was able to find the issue which was causing the pdf to be not built
properly.
==
diff --git a/filesystem/trivial_ftp.rst b/filesystem/trivial_ftp.rst
index 3ef8bba..eccd035 100644
--- a/filesystem/trivial_ftp.rst
+++ b/filesystem/trivial_ftp.rst
@@ -280,10 +280,7 @@ application.  The mount point can be any directory.
The name ``/tftp``
  used in the figure serves only as an example.  The final unmounting and
  remove directory steps are optional.

-.. figure:: ../images/filesystem/tftpfs_usage.png
-  :width: 90%
-  :align: center
-  :alt: TFTP Usage Diagram
+
===
This png is causing issues. Removing these lines removed the error and
the pdf was generated successfully. I hope this is helpful.


Thanks. I saw this email right as I was setting up to do a git bisect with
my
morning tea.

Two issues with this figure situation.

(1) We probably should not have png/jpg files without the corresponding
source.

(2) I have no idea how to fix this other than to remove the figure. It
looks like Frank's
text is referencing the figure so simply removing it isn't the best answer.

--joel


Thanks,
Noor

On Sat, 8 Oct 2022 at 05:35, Chris Johns  wrote:


On 8/10/2022 9:47 am, Chris Johns wrote:

On 8/10/2022 10:12 am, Noor Aman wrote:

I can confirm that the same is happening on my PC too.

Could you please bisect the repo to find the patch that broke things?

A simpler way to find the commit is to see the last build on
docs.rtems.org
which is 6.278550b and the next commit after 278550b is:

commit 23fc93bf648507ac417237c20069c4ab7c793251
Author: Frank Kühndel
Date:   Thu Jun 9 15:21:05 2022 +0200

 TFTPFS: New documentation

Frank ?


--
embedded brains GmbH
Herr Frank KÜHNDEL
Dornierstr. 4
82178 Puchheim
Germany
email: frank.kuehn...@embedded-brains.de
phone:  +49-89-18 94 741 - 23
mobile: +49-176-15 22 06 - 11
fax:+49-89-18 94 741 - 08

Registergericht: Amtsgericht München
Registernummer: HRB 157899
Vertretungsberechtigte Geschäftsführer: Peter Rasmussen, Thomas Dörfler
Unsere Datenschutzerklärung finden Sie hier:
https://embedded-brains.de/datenschutzerklaerung/

___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-10 Thread Chris Johns 
On 10/10/2022 9:22 pm, Frank Kühndel wrote:
> images/filesystem/tftpfs_usage.png:
> https://share.embedded-brains.de/index.php/s/fQ4WrLrqmBjcbwC
I have a greyed out image I cannot clearly see?

> images/filesystem/ftpfs_usage.svg:
> https://share.embedded-brains.de/index.php/s/xk7kArkm6mbjcn2
> 
> The SVG file is the source for the PNG. Both files must be placed in the
> images/filesystem folder.

How is the SVG file created and how can it be edited?

Chris
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-11 Thread Chris Johns 
On 11/10/2022 7:12 pm, Frank Kühndel wrote:
> Hello Chris,
> 
> On 10/11/22 03:09, Chris Johns wrote:
>> On 10/10/2022 9:22 pm, Frank Kühndel wrote:
>>> images/filesystem/tftpfs_usage.png:
>>> https://share.embedded-brains.de/index.php/s/fQ4WrLrqmBjcbwC
>> I have a greyed out image I cannot clearly see?
> 
> The image has a transparent background. Some image viewers put a gray pattern 
> in
> the background in those case. The PDF has naturally a white background on top 
> of
> which the image is displayed.
> 
>>
>>> images/filesystem/ftpfs_usage.svg:
>>> https://share.embedded-brains.de/index.php/s/xk7kArkm6mbjcn2
>>>
>>> The SVG file is the source for the PNG. Both files must be placed in the
>>> images/filesystem folder.
>> How is the SVG file created and how can it be edited?
> 
> I used Inkscape. It should be possible to edit it with (almost) any tool that
> supports SVG. 

I tried with https://pixelied.com/features/svg-editor and it was a mess.

My concern is the widgets (or whatever they are called) a tool has may not be
available in another.

> Your Web-Browser should be able to display SVG directly when you
> point it to the file like for example: 
> file:///home//tftpfs_usage.svg
> 
> You can recreate the PNG with Inkscape on the command line with:
> 
> $ inkscape --export-dpi=300 --export-filename=tftpfs_usage.png 
> tftpfs_usage.svg

We have a number of images in the doco created using PlantUML. Did you consider
using that tool? It has the advantage the images can be regenerated from the
source as part of the build if PlantUML and Ditaa are installed and we get a
consistent looking set of images.

Chris
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-12 Thread Frank Kühndel 

Hello Chris,

On 10/11/22 23:47, Chris Johns wrote:

On 11/10/2022 7:12 pm, Frank Kühndel wrote:

Hello Chris,

On 10/11/22 03:09, Chris Johns wrote:

On 10/10/2022 9:22 pm, Frank Kühndel wrote:

images/filesystem/tftpfs_usage.png:
https://share.embedded-brains.de/index.php/s/fQ4WrLrqmBjcbwC

I have a greyed out image I cannot clearly see?

The image has a transparent background. Some image viewers put a gray pattern in
the background in those case. The PDF has naturally a white background on top of
which the image is displayed.


images/filesystem/ftpfs_usage.svg:
https://share.embedded-brains.de/index.php/s/xk7kArkm6mbjcn2

The SVG file is the source for the PNG. Both files must be placed in the
images/filesystem folder.

How is the SVG file created and how can it be edited?

I used Inkscape. It should be possible to edit it with (almost) any tool that
supports SVG.

I tried withhttps://pixelied.com/features/svg-editor  and it was a mess.


Yes. I tried another Web-based tool and it was the same mess. Yet, all 
converter handle this correctly. For example:


$ firefox file:///home/frank/tftpfs_usage.svg
$ convert -geometry 1422x1574 tftpfs_usage.svg tftpfs_usage.png
$ display tftpfs_usage.svg
$ libreoffice tftpfs_usage.svg
$ rsvg-convert --width 1422 --height 1574 -o tftpfs_usage_Z.png 
tftpfs_usage.svg


So, I guess it is a bug in the web-based tools.



My concern is the widgets (or whatever they are called) a tool has may not be
available in another.


Inkscape is open source and available freely on (almost?) all operating 
system. It is *the* standard open source tool for producing high-quality 
vector graphics today.





Your Web-Browser should be able to display SVG directly when you
point it to the file like for example:file:///home//tftpfs_usage.svg

You can recreate the PNG with Inkscape on the command line with:

$ inkscape --export-dpi=300 --export-filename=tftpfs_usage.png tftpfs_usage.svg

We have a number of images in the doco created using PlantUML. Did you consider
using that tool? It has the advantage the images can be regenerated from the
source as part of the build if PlantUML and Ditaa are installed and we get a
consistent looking set of images.


I took a look into PlantUML:

* My image is not an UML diagram (or similar to another diagram input 
format it supports)
* It may be realized as an Activity Diagram, yet. But it will not look 
very similar to the current image.
* Most of all, I will need to spend significant time to learn PlantUML 
and to get the result in shape I will certainly need to do some trying 
and fumbling around.


Openly, my company will never pay me for converting the image to 
PlantUML. Sorry about this.


Do you see any solution to this problem?

Greetings
Frank

--
embedded brains GmbH
Herr Frank KÜHNDEL
Dornierstr. 4
82178 Puchheim
Germany
email: frank.kuehn...@embedded-brains.de
phone:  +49-89-18 94 741 - 23
mobile: +49-176-15 22 06 - 11
fax:+49-89-18 94 741 - 08

Registergericht: Amtsgericht München
Registernummer: HRB 157899
Vertretungsberechtigte Geschäftsführer: Peter Rasmussen, Thomas Dörfler
Unsere Datenschutzerklärung finden Sie hier:
https://embedded-brains.de/datenschutzerklaerung/

___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-12 Thread Chris Johns 


On 12/10/2022 8:56 pm, Frank Kühndel wrote:
> Hello Chris,
> On 10/11/22 23:47, Chris Johns wrote:
>> On 11/10/2022 7:12 pm, Frank Kühndel wrote:
>>> Hello Chris,
>>>
>>> On 10/11/22 03:09, Chris Johns wrote:
 On 10/10/2022 9:22 pm, Frank Kühndel wrote:
> images/filesystem/tftpfs_usage.png:
> https://share.embedded-brains.de/index.php/s/fQ4WrLrqmBjcbwC
 I have a greyed out image I cannot clearly see?
>>> The image has a transparent background. Some image viewers put a gray 
>>> pattern in
>>> the background in those case. The PDF has naturally a white background on 
>>> top of
>>> which the image is displayed.
>>>
> images/filesystem/ftpfs_usage.svg:
> https://share.embedded-brains.de/index.php/s/xk7kArkm6mbjcn2
>
> The SVG file is the source for the PNG. Both files must be placed in the
> images/filesystem folder.
 How is the SVG file created and how can it be edited?
>>> I used Inkscape. It should be possible to edit it with (almost) any tool 
>>> that
>>> supports SVG.
>> I tried withhttps://pixelied.com/features/svg-editor  and it was a mess.
> 
> Yes. I tried another Web-based tool and it was the same mess. Yet, all 
> converter
> handle this correctly. For example:
> 
> $ firefox file:///home/frank/tftpfs_usage.svg
> $ convert -geometry 1422x1574 tftpfs_usage.svg tftpfs_usage.png
> $ display tftpfs_usage.svg
> $ libreoffice tftpfs_usage.svg
> $ rsvg-convert --width 1422 --height 1574 -o tftpfs_usage_Z.png 
> tftpfs_usage.svg
> 
> So, I guess it is a bug in the web-based tools.

The format is always going to be fragile and locked into the specific tool used
to create it. Being an open format does not help. Word is a form of XML and it
is also not suitable.

>> My concern is the widgets (or whatever they are called) a tool has may not be
>> available in another.
> 
> Inkscape is open source and available freely on (almost?) all operating 
> system.
> It is *the* standard open source tool for producing high-quality vector 
> graphics
> today.

I do not agree and I question "the" in your last sentence. Making a fact of your
view does not impress me.

We need a solution that can be maintained past your current employment.

>>> Your Web-Browser should be able to display SVG directly when you
>>> point it to the file like for 
>>> example:file:///home//tftpfs_usage.svg
>>>
>>> You can recreate the PNG with Inkscape on the command line with:
>>>
>>> $ inkscape --export-dpi=300 --export-filename=tftpfs_usage.png 
>>> tftpfs_usage.svg
>> We have a number of images in the doco created using PlantUML. Did you 
>> consider
>> using that tool? It has the advantage the images can be regenerated from the
>> source as part of the build if PlantUML and Ditaa are installed and we get a
>> consistent looking set of images.
> 
> I took a look into PlantUML:
> 
> * My image is not an UML diagram (or similar to another diagram input format 
> it
> supports)

Ditaa is an option and easy to use.

> * It may be realized as an Activity Diagram, yet. But it will not look very
> similar to the current image.
>
> * Most of all, I will need to spend significant time to learn PlantUML and to
> get the result in shape I will certainly need to do some trying and fumbling
> around.

Maybe an example would help:

https://git.rtems.org/rtems-docs/tree/images/user/exe-debug-libdebugger.ditaa

> Openly, my company will never pay me for converting the image to PlantUML. 
> Sorry
> about this.

Seems you have made this a commercial issue on a public mailing list I have
included Thomas on the email and he can reach out me directly. I always enjoy
catching up with him.

> Do you see any solution to this problem?

1. Revert the patch.

2. Use something like ditaa

3. Reword the section to not include the image

In the mean time the docs are not building.

Chris
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-12 Thread Sam Price 
Have you guys looked at mermaidjs for simplistic diagrams?
https://mermaid-js.github.io/mermaid/#/flowchart

You can embed it in markdown. pandoc will convert it to images for html.
it works on gitlab wiki, and prob others.

On Wed, Oct 12, 2022 at 8:31 PM Chris Johns  wrote:

>
>
> On 12/10/2022 8:56 pm, Frank Kühndel wrote:
> > Hello Chris,
> > On 10/11/22 23:47, Chris Johns wrote:
> >> On 11/10/2022 7:12 pm, Frank Kühndel wrote:
> >>> Hello Chris,
> >>>
> >>> On 10/11/22 03:09, Chris Johns wrote:
>  On 10/10/2022 9:22 pm, Frank Kühndel wrote:
> > images/filesystem/tftpfs_usage.png:
> > https://share.embedded-brains.de/index.php/s/fQ4WrLrqmBjcbwC
>  I have a greyed out image I cannot clearly see?
> >>> The image has a transparent background. Some image viewers put a gray
> pattern in
> >>> the background in those case. The PDF has naturally a white background
> on top of
> >>> which the image is displayed.
> >>>
> > images/filesystem/ftpfs_usage.svg:
> > https://share.embedded-brains.de/index.php/s/xk7kArkm6mbjcn2
> >
> > The SVG file is the source for the PNG. Both files must be placed in
> the
> > images/filesystem folder.
>  How is the SVG file created and how can it be edited?
> >>> I used Inkscape. It should be possible to edit it with (almost) any
> tool that
> >>> supports SVG.
> >> I tried withhttps://pixelied.com/features/svg-editor  and it was a
> mess.
> >
> > Yes. I tried another Web-based tool and it was the same mess. Yet, all
> converter
> > handle this correctly. For example:
> >
> > $ firefox file:///home/frank/tftpfs_usage.svg
> > $ convert -geometry 1422x1574 tftpfs_usage.svg tftpfs_usage.png
> > $ display tftpfs_usage.svg
> > $ libreoffice tftpfs_usage.svg
> > $ rsvg-convert --width 1422 --height 1574 -o tftpfs_usage_Z.png
> tftpfs_usage.svg
> >
> > So, I guess it is a bug in the web-based tools.
>
> The format is always going to be fragile and locked into the specific tool
> used
> to create it. Being an open format does not help. Word is a form of XML
> and it
> is also not suitable.
>
> >> My concern is the widgets (or whatever they are called) a tool has may
> not be
> >> available in another.
> >
> > Inkscape is open source and available freely on (almost?) all operating
> system.
> > It is *the* standard open source tool for producing high-quality vector
> graphics
> > today.
>
> I do not agree and I question "the" in your last sentence. Making a fact
> of your
> view does not impress me.
>
> We need a solution that can be maintained past your current employment.
>
> >>> Your Web-Browser should be able to display SVG directly when you
> >>> point it to the file like for
> example:file:///home//tftpfs_usage.svg
> >>>
> >>> You can recreate the PNG with Inkscape on the command line with:
> >>>
> >>> $ inkscape --export-dpi=300 --export-filename=tftpfs_usage.png
> tftpfs_usage.svg
> >> We have a number of images in the doco created using PlantUML. Did you
> consider
> >> using that tool? It has the advantage the images can be regenerated
> from the
> >> source as part of the build if PlantUML and Ditaa are installed and we
> get a
> >> consistent looking set of images.
> >
> > I took a look into PlantUML:
> >
> > * My image is not an UML diagram (or similar to another diagram input
> format it
> > supports)
>
> Ditaa is an option and easy to use.
>
> > * It may be realized as an Activity Diagram, yet. But it will not look
> very
> > similar to the current image.
> >
> > * Most of all, I will need to spend significant time to learn PlantUML
> and to
> > get the result in shape I will certainly need to do some trying and
> fumbling
> > around.
>
> Maybe an example would help:
>
>
> https://git.rtems.org/rtems-docs/tree/images/user/exe-debug-libdebugger.ditaa
>
> > Openly, my company will never pay me for converting the image to
> PlantUML. Sorry
> > about this.
>
> Seems you have made this a commercial issue on a public mailing list I have
> included Thomas on the email and he can reach out me directly. I always
> enjoy
> catching up with him.
>
> > Do you see any solution to this problem?
>
> 1. Revert the patch.
>
> 2. Use something like ditaa
>
> 3. Reword the section to not include the image
>
> In the mean time the docs are not building.
>
> Chris
> ___
> devel mailing list
> devel@rtems.org
> http://lists.rtems.org/mailman/listinfo/devel



-- 
Sincerely,

Sam Price
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-12 Thread Chris Johns 
On 13/10/2022 2:01 pm, Sam Price wrote:
> Have you guys looked at mermaidjs for simplistic diagrams?
> https://mermaid-js.github.io/mermaid/#/flowchart
> 

No I have not.

> You can embed it in markdown. pandoc will convert it to images for html.
> it works on gitlab wiki, and prob others.

Can it generate a format we can embed in PDFs?

Chris
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-12 Thread Sam Price 
Yes
https://github.com/mermaid-js/mermaid-cli

There are command line tools so it can be integrated into pipelines.
Convert Mermaid mmd Diagram File To SVG

mmdc -i input.mmd -o output.svg

Create
A PNG With A Dark Theme And Transparent Background

mmdc -i input.mmd -o output.png -t dark -b transparent

You dont get much control though over how it places boxes.
But it does sequence diagrams.
Im using it for gantt charts.

Its one of the mainstream alternatives to plantuml
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-12 Thread Chris Johns 
On 13/10/2022 3:15 pm, Sam Price wrote:
> Yes
> https://github.com/mermaid-js/mermaid-cli
> 
> 
> There are command line tools so it can be integrated into pipelines.
> 
> 
>   Convert Mermaid mmd Diagram File To SVG
> 
> mmdc -i input.mmd -o output.svg
> 
> 
>   
> Create
>  A PNG With A Dark Theme And Transparent Background
> 
> mmdc -i input.mmd -o output.png -t dark -b transparent
> 
> You dont get much control though over how it places boxes. 
> But it does sequence diagrams.
> Im using it for gantt charts.
> 
> Its one of the mainstream alternatives to plantuml
> 

This tool looks really good and it fits the pattern of tools we can use.

Thanks for this.
Chris
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-12 Thread Sam Price 
example

https://mermaid.live/edit#pako:eNqFVG1vmzAQ_iuWP6UVaZM0DQGlkSYlnSJ1bUUyddmYkAlmYQEbGVP6sv732cdrtSrj0z0v9p19h1_xjgcU2ziTRNJFRH4JkvQfRy5zWcQi6WeBjVYqiEgcvVAUR76iSu2WyoKLwzu94lyWHBaRsNGOs0yi3Z4IdJrwnEkv5RGT6Aq5-FyGMnXxzBfnc0GzPNZ0cggi0UMdr4HW3sp5-PYV_amiz010dwKrdbWwAnK2e2mqh8CC9OdiFxsN7OZoSGez_LL2rlc3y_V2rWJvs71fepvrzf36iMlZflp4D85qs2xNLvZjvjtk6lquhoPR2CgiFvAC8Nh4pMLnGXVxWd6JPgJPKRPcRmGgitegh1Ii9wa685zF3e3NFimboES1xH-WNFMujXpqgYECIonn52FIhaHT6zw87HV5dFJvsItV7s5NAdb7aIPOXHxYxYNTV1GISNK2DIBtHQZkb3xHs-XQho6as6pv3XnRdSfBu-4C_sflMji8nmYUqkn0ynA202A-L2WEfpz-RP3-HFUzXtMVbKRmnFu5osACQ16LAEq6GsVGqTCIbVG1fIyBJeVc1GKJQNCtrGkdHyfh2rsKECCXTTiSvuhmL4CG1tY0gP_S7ypomQ9KKLOXnGreb9XetnkVDefSQ4ANnFCRkChQD9mrdrlY7mmi_i5bhQENiRoZ9fOzN2UlueTrZ7bDthQ5NXCeBu3Th-2QxJliU8K-c57UJgWx_YqfsD0cDs6soXk5mlyMR2PTmkwN_Kzo0dn4cmxZg4FlTqeTifVm4BfYQNkvLNMyzUvLvJhMp6b59hcqM78E

SVG link
https://mermaid.ink/svg/pako:eNqFVG1v2jAQ_iuWP0GVtrxDIoo0CTohdaUCJsaWKXKIMzKIjRynKWX899mXV7SK5dM9L_adfRef8IZ7FFs4kkTScUB-CRLevrZsZrOABdKNPAtNVRCQffBO0T5wFZVqz1QmXOwu9IyzWbgbB8JCG84iiTZbItBNyGMmnQMPmEQPyMb30pcHGw9dcT8SNIr3mg53XiBqqOI10MKZzlffvqI_WfS5iGZ1WK2rhRWQs9xLUzUEFqQ_G9vYKGA1R0HOl5MvC-dx-jRZrBcqdpbrl4mzfFy-LK6Y5pNPY2c1ny4npcnG7p5vdpG6lodmo9UxkoB5PAHcMV6pcHlEbZyWV9dH4AfKBLeQ76niNaihA5FbA82c-Xj2_LRGyiYoUS1xj5JGyqVRTS0wkEckcdzY96kwdHqdh_u1Ko_q-QabvcpduSnAeh9t0JmTD6tYzfMqEhFIWpYBsKzDgOyF72q2GNpQUWOW9a06L7ru0LvoLuB_XDaDw-tpRr6aRCcNh0MNRqNURujHzU90eztC2YzndAYLqRjnUs4osMCQ5yKAlM5GsVAyDGJZVC5fY2BJOhe5mCIQdCtzWsfXSbj2qgIEyGkTrqRPqtkToKG1OQ3gv_RFBSXzQQlp9pRTzfut2ls2L6PhXHoIsIFDKkISeOohO2mXjeWWhurvslToUZ-okVE_PzsrK4klXxzZBltSxNTA8cErn76cPBD2nfMqxNYJv2Gr2Wzcmc1-t9Vrd1qdvtkbGPio6NZdp9sxzUbD7A8GvZ55NvA7bKDsbbNv9vtds9HtNcxm-_wXZ4G-ow


I couldn't figure out how to get semi colons to work
new lines are kind  of a pain also.

stateDiagram-v2

initbsd: Initialize libbsd
initNetwork: Initialize Network
mkDir: const char *mount_point = "/tftp"result = mkdir( mount_point,
S_IRWXU | S_IRWXG | S_IRWXO)

mountDir: result = mount(  "", mount_point,
RTEMS_FILESYSTEM_TYPE_TFTPS, RTEMS_FILESYSTEM_READ_WRITE,
"blocksize=1024,windowsize=4,verbose" )

openro: fd = open( path, O_RDONLY )
read: bytes = read( fd, data_buffer, sizeof( data_buffer ) )
readclose: result = close( fd )
openw: fd = open( path, O_WRONLY )
write: bytes = write( fd, data, size )
writeclose: result = close( fd )
umount: result = unmount( mount_point )
rmdir: result = rmdir( mount_point )

state fork_state <>
[*] --> initbsd
initbsd --> initNetwork
initNetwork --> mkDir
mkDir --> mountDir
mountDir --> fork_state
fork_state
fork_state --> openro
openro --> read
read --> read
read --> readclose
readclose --> umount
fork_state --> openw
openw --> write
write --> write
write --> writeclose
writeclose --> umount
state umount <>
umount --> rmdir
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-12 Thread Chris Johns 
On 13/10/2022 4:06 pm, Sam Price wrote:
> example
> 
> https://mermaid.live/edit#pako:eNqFVG1vmzAQ_iuWP6UVaZM0DQGlkSYlnSJ1bUUyddmYkAlmYQEbGVP6sv732cdrtSrj0z0v9p19h1_xjgcU2ziTRNJFRH4JkvQfRy5zWcQi6WeBjVYqiEgcvVAUR76iSu2WyoKLwzu94lyWHBaRsNGOs0yi3Z4IdJrwnEkv5RGT6Aq5-FyGMnXxzBfnc0GzPNZ0cggi0UMdr4HW3sp5-PYV_amiz010dwKrdbWwAnK2e2mqh8CC9OdiFxsN7OZoSGez_LL2rlc3y_V2rWJvs71fepvrzf36iMlZflp4D85qs2xNLvZjvjtk6lquhoPR2CgiFvAC8Nh4pMLnGXVxWd6JPgJPKRPcRmGgitegh1Ii9wa685zF3e3NFimboES1xH-WNFMujXpqgYECIonn52FIhaHT6zw87HV5dFJvsItV7s5NAdb7aIPOXHxYxYNTV1GISNK2DIBtHQZkb3xHs-XQho6as6pv3XnRdSfBu-4C_sflMji8nmYUqkn0ynA202A-L2WEfpz-RP3-HFUzXtMVbKRmnFu5osACQ16LAEq6GsVGqTCIbVG1fIyBJeVc1GKJQNCtrGkdHyfh2rsKECCXTTiSvuhmL4CG1tY0gP_S7ypomQ9KKLOXnGreb9XetnkVDefSQ4ANnFCRkChQD9mrdrlY7mmi_i5bhQENiRoZ9fOzN2UlueTrZ7bDthQ5NXCeBu3Th-2QxJliU8K-c57UJgWx_YqfsD0cDs6soXk5mlyMR2PTmkwN_Kzo0dn4cmxZg4FlTqeTifVm4BfYQNkvLNMyzUvLvJhMp6b59hcqM78E
>  
> 
> 
> SVG link
> https://mermaid.ink/svg/pako:eNqFVG1v2jAQ_iuWP0GVtrxDIoo0CTohdaUCJsaWKXKIMzKIjRynKWX899mXV7SK5dM9L_adfRef8IZ7FFs4kkTScUB-CRLevrZsZrOABdKNPAtNVRCQffBO0T5wFZVqz1QmXOwu9IyzWbgbB8JCG84iiTZbItBNyGMmnQMPmEQPyMb30pcHGw9dcT8SNIr3mg53XiBqqOI10MKZzlffvqI_WfS5iGZ1WK2rhRWQs9xLUzUEFqQ_G9vYKGA1R0HOl5MvC-dx-jRZrBcqdpbrl4mzfFy-LK6Y5pNPY2c1ny4npcnG7p5vdpG6lodmo9UxkoB5PAHcMV6pcHlEbZyWV9dH4AfKBLeQ76niNaihA5FbA82c-Xj2_LRGyiYoUS1xj5JGyqVRTS0wkEckcdzY96kwdHqdh_u1Ko_q-QabvcpduSnAeh9t0JmTD6tYzfMqEhFIWpYBsKzDgOyF72q2GNpQUWOW9a06L7ru0LvoLuB_XDaDw-tpRr6aRCcNh0MNRqNURujHzU90eztC2YzndAYLqRjnUs4osMCQ5yKAlM5GsVAyDGJZVC5fY2BJOhe5mCIQdCtzWsfXSbj2qgIEyGkTrqRPqtkToKG1OQ3gv_RFBSXzQQlp9pRTzfut2ls2L6PhXHoIsIFDKkISeOohO2mXjeWWhurvslToUZ-okVE_PzsrK4klXxzZBltSxNTA8cErn76cPBD2nfMqxNYJv2Gr2Wzcmc1-t9Vrd1qdvtkbGPio6NZdp9sxzUbD7A8GvZ55NvA7bKDsbbNv9vtds9HtNcxm-_wXZ4G-ow
>  
> 
> 
> 
> I couldn't figure out how to get semi colons to work
> new lines are kind  of a pain also.

You are a legend (pun intended) :D

It is looking goo but Frank has the final say.

Chris

> 
> stateDiagram-v2
> 
> initbsd:Initialize libbsd
> initNetwork:Initialize Network
> mkDir:const char *mount_point = "/tftp"result = mkdir( mount_point, 
> S_IRWXU
> | S_IRWXG | S_IRWXO)
> 
> mountDir:result = mount(  "", mount_point,
> RTEMS_FILESYSTEM_TYPE_TFTPS, RTEMS_FILESYSTEM_READ_WRITE,
> "blocksize=1024,windowsize=4,verbose" )
> 
> openro:fd = open( path, O_RDONLY )
> read:bytes = read( fd, data_buffer, sizeof( data_buffer ) )
> readclose:result = close( fd )
> openw:fd = open( path, O_WRONLY )
> write:bytes = write( fd, data, size )
> writeclose:result = close( fd )
> umount:result = unmount( mount_point )
> rmdir:result = rmdir( mount_point )
> 
> state fork_state <>
> [*] --> initbsd
> initbsd --> initNetwork
> initNetwork --> mkDir
> mkDir --> mountDir
> mountDir --> fork_state
> fork_state
> fork_state --> openro
> openro --> read
> read --> read
> read --> readclose
> readclose --> umount
> fork_state --> openw
> openw --> write
> write --> write
> write --> writeclose
> writeclose --> umount
> state umount <>
> umount --> rmdir
> 
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-12 Thread Sam Price 
I forgot the loop backs. from close back to open.

On Thu, Oct 13, 2022 at 1:12 AM Chris Johns  wrote:

> On 13/10/2022 4:06 pm, Sam Price wrote:
> > example
> >
> >
> https://mermaid.live/edit#pako:eNqFVG1vmzAQ_iuWP6UVaZM0DQGlkSYlnSJ1bUUyddmYkAlmYQEbGVP6sv732cdrtSrj0z0v9p19h1_xjgcU2ziTRNJFRH4JkvQfRy5zWcQi6WeBjVYqiEgcvVAUR76iSu2WyoKLwzu94lyWHBaRsNGOs0yi3Z4IdJrwnEkv5RGT6Aq5-FyGMnXxzBfnc0GzPNZ0cggi0UMdr4HW3sp5-PYV_amiz010dwKrdbWwAnK2e2mqh8CC9OdiFxsN7OZoSGez_LL2rlc3y_V2rWJvs71fepvrzf36iMlZflp4D85qs2xNLvZjvjtk6lquhoPR2CgiFvAC8Nh4pMLnGXVxWd6JPgJPKRPcRmGgitegh1Ii9wa685zF3e3NFimboES1xH-WNFMujXpqgYECIonn52FIhaHT6zw87HV5dFJvsItV7s5NAdb7aIPOXHxYxYNTV1GISNK2DIBtHQZkb3xHs-XQho6as6pv3XnRdSfBu-4C_sflMji8nmYUqkn0ynA202A-L2WEfpz-RP3-HFUzXtMVbKRmnFu5osACQ16LAEq6GsVGqTCIbVG1fIyBJeVc1GKJQNCtrGkdHyfh2rsKECCXTTiSvuhmL4CG1tY0gP_S7ypomQ9KKLOXnGreb9XetnkVDefSQ4ANnFCRkChQD9mrdrlY7mmi_i5bhQENiRoZ9fOzN2UlueTrZ7bDthQ5NXCeBu3Th-2QxJliU8K-c57UJgWx_YqfsD0cDs6soXk5mlyMR2PTmkwN_Kzo0dn4cmxZg4FlTqeTifVm4BfYQNkvLNMyzUvLvJhMp6b59hcqM78E
> <
> https://mermaid.live/edit#pako:eNqFVG1vmzAQ_iuWP6UVaZM0DQGlkSYlnSJ1bUUyddmYkAlmYQEbGVP6sv732cdrtSrj0z0v9p19h1_xjgcU2ziTRNJFRH4JkvQfRy5zWcQi6WeBjVYqiEgcvVAUR76iSu2WyoKLwzu94lyWHBaRsNGOs0yi3Z4IdJrwnEkv5RGT6Aq5-FyGMnXxzBfnc0GzPNZ0cggi0UMdr4HW3sp5-PYV_amiz010dwKrdbWwAnK2e2mqh8CC9OdiFxsN7OZoSGez_LL2rlc3y_V2rWJvs71fepvrzf36iMlZflp4D85qs2xNLvZjvjtk6lquhoPR2CgiFvAC8Nh4pMLnGXVxWd6JPgJPKRPcRmGgitegh1Ii9wa685zF3e3NFimboES1xH-WNFMujXpqgYECIonn52FIhaHT6zw87HV5dFJvsItV7s5NAdb7aIPOXHxYxYNTV1GISNK2DIBtHQZkb3xHs-XQho6as6pv3XnRdSfBu-4C_sflMji8nmYUqkn0ynA202A-L2WEfpz-RP3-HFUzXtMVbKRmnFu5osACQ16LAEq6GsVGqTCIbVG1fIyBJeVc1GKJQNCtrGkdHyfh2rsKECCXTTiSvuhmL4CG1tY0gP_S7ypomQ9KKLOXnGreb9XetnkVDefSQ4ANnFCRkChQD9mrdrlY7mmi_i5bhQENiRoZ9fOzN2UlueTrZ7bDthQ5NXCeBu3Th-2QxJliU8K-c57UJgWx_YqfsD0cDs6soXk5mlyMR2PTmkwN_Kzo0dn4cmxZg4FlTqeTifVm4BfYQNkvLNMyzUvLvJhMp6b59hcqM78E
> >
> >
> > SVG link
> >
> https://mermaid.ink/svg/pako:eNqFVG1v2jAQ_iuWP0GVtrxDIoo0CTohdaUCJsaWKXKIMzKIjRynKWX899mXV7SK5dM9L_adfRef8IZ7FFs4kkTScUB-CRLevrZsZrOABdKNPAtNVRCQffBO0T5wFZVqz1QmXOwu9IyzWbgbB8JCG84iiTZbItBNyGMmnQMPmEQPyMb30pcHGw9dcT8SNIr3mg53XiBqqOI10MKZzlffvqI_WfS5iGZ1WK2rhRWQs9xLUzUEFqQ_G9vYKGA1R0HOl5MvC-dx-jRZrBcqdpbrl4mzfFy-LK6Y5pNPY2c1ny4npcnG7p5vdpG6lodmo9UxkoB5PAHcMV6pcHlEbZyWV9dH4AfKBLeQ76niNaihA5FbA82c-Xj2_LRGyiYoUS1xj5JGyqVRTS0wkEckcdzY96kwdHqdh_u1Ko_q-QabvcpduSnAeh9t0JmTD6tYzfMqEhFIWpYBsKzDgOyF72q2GNpQUWOW9a06L7ru0LvoLuB_XDaDw-tpRr6aRCcNh0MNRqNURujHzU90eztC2YzndAYLqRjnUs4osMCQ5yKAlM5GsVAyDGJZVC5fY2BJOhe5mCIQdCtzWsfXSbj2qgIEyGkTrqRPqtkToKG1OQ3gv_RFBSXzQQlp9pRTzfut2ls2L6PhXHoIsIFDKkISeOohO2mXjeWWhurvslToUZ-okVE_PzsrK4klXxzZBltSxNTA8cErn76cPBD2nfMqxNYJv2Gr2Wzcmc1-t9Vrd1qdvtkbGPio6NZdp9sxzUbD7A8GvZ55NvA7bKDsbbNv9vtds9HtNcxm-_wXZ4G-ow
> <
> https://mermaid.ink/svg/pako:eNqFVG1v2jAQ_iuWP0GVtrxDIoo0CTohdaUCJsaWKXKIMzKIjRynKWX899mXV7SK5dM9L_adfRef8IZ7FFs4kkTScUB-CRLevrZsZrOABdKNPAtNVRCQffBO0T5wFZVqz1QmXOwu9IyzWbgbB8JCG84iiTZbItBNyGMmnQMPmEQPyMb30pcHGw9dcT8SNIr3mg53XiBqqOI10MKZzlffvqI_WfS5iGZ1WK2rhRWQs9xLUzUEFqQ_G9vYKGA1R0HOl5MvC-dx-jRZrBcqdpbrl4mzfFy-LK6Y5pNPY2c1ny4npcnG7p5vdpG6lodmo9UxkoB5PAHcMV6pcHlEbZyWV9dH4AfKBLeQ76niNaihA5FbA82c-Xj2_LRGyiYoUS1xj5JGyqVRTS0wkEckcdzY96kwdHqdh_u1Ko_q-QabvcpduSnAeh9t0JmTD6tYzfMqEhFIWpYBsKzDgOyF72q2GNpQUWOW9a06L7ru0LvoLuB_XDaDw-tpRr6aRCcNh0MNRqNURujHzU90eztC2YzndAYLqRjnUs4osMCQ5yKAlM5GsVAyDGJZVC5fY2BJOhe5mCIQdCtzWsfXSbj2qgIEyGkTrqRPqtkToKG1OQ3gv_RFBSXzQQlp9pRTzfut2ls2L6PhXHoIsIFDKkISeOohO2mXjeWWhurvslToUZ-okVE_PzsrK4klXxzZBltSxNTA8cErn76cPBD2nfMqxNYJv2Gr2Wzcmc1-t9Vrd1qdvtkbGPio6NZdp9sxzUbD7A8GvZ55NvA7bKDsbbNv9vtds9HtNcxm-_wXZ4G-ow
> >
> >
> >
> > I couldn't figure out how to get semi colons to work
> > new lines are kind  of a pain also.
>
> You are a legend (pun intended) :D
>
> It is looking goo but Frank has the final say.
>
> Chris
>
> >
> > stateDiagram-v2
> >
> > initbsd:Initialize libbsd
> > initNetwork:Initialize Network
> > mkDir:const char *mount_point = "/tftp"result = mkdir( mount_point,
> S_IRWXU
> > | S_IRWXG | S_IRWXO)
> >
> > mountDir:result = mount(  "", mount_point,
> > RTEMS_FILESYSTEM_TYPE_TFTPS, RTEMS_FILESYSTEM_READ_WRITE,
> > "blocksize=1024,windowsize=4,verbose" )
> >
> > openro:fd = open( path, O_RDONLY )
> > read:bytes = read( fd, data_buffer, sizeof( data_buffer ) )
> > readclose:result = close( fd )
> > openw:fd = open( path, O_WRONLY )
> > write:bytes = write( fd, data, size )
> > writeclose:result = close( fd )
> > umount:result = unmount( mount_point )
> > rmdir:result = rmdir( mount_point )
> >
> > state fork_state <>
> > [*] --> initbsd
> > initbsd --> initNetwork
> > initNetwork --> mkDir
> > mkDir --> mountDir
> > mountDir --> fork_state
> > fork_state
> > fork_state --> openro
> > openro --> read
> > read --> read
> > read --> readclose
> > readclose --> umount
> > fork_state --> openw
> > openw --> write
> > write --> write
> > write --> writeclose
> > writeclose --> umount
> > state umount <>
> > umount --> rmdir
> >
>


-- 
Sincerely,

Sam Price

RE: docs not building to PDF

2022-10-13 Thread Jan.Sommer 
There is also Kroki: https://kroki.io/
It does the rendering of multiple text based diagram languages, including 
PlantUML, Mermaid, Ditaa and a bunch of others.
Then you only need one tool for it.

Best regards,

Jan

> -Original Message-
> From: devel  On Behalf Of Chris Johns
> Sent: Thursday, October 13, 2022 6:22 AM
> To: Sam Price 
> Cc: Development 
> Subject: Re: docs not building to PDF
>
> On 13/10/2022 3:15 pm, Sam Price wrote:
> > Yes
> > https://github.com/mermaid-js/mermaid-cli
> > <https://github.com/mermaid-js/mermaid-cli>
> >
> > There are command line tools so it can be integrated into pipelines.
> >
> >
> >   Convert Mermaid mmd Diagram File To SVG
> >
> > mmdc -i input.mmd -o output.svg
> >
> >
> >
> > <https://github.com/mermaid-js/mermaid-cli#create-a-png-with-a-dark-
> th
> > eme-and-transparent-background>Create A PNG With A Dark Theme And
> > Transparent Background
> >
> > mmdc -i input.mmd -o output.png -t dark -b transparent
> >
> > You dont get much control though over how it places boxes. But it does
> > sequence diagrams.
> > Im using it for gantt charts.
> >
> > Its one of the mainstream alternatives to plantuml
> >
>
> This tool looks really good and it fits the pattern of tools we can use.
>
> Thanks for this.
> Chris
> ___
> devel mailing list
> devel@rtems.org
> http://lists.rtems.org/mailman/listinfo/devel


smime.p7s
Description: S/MIME cryptographic signature
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-13 Thread Sam Price 
Also imagine magick has a command line converter

https://imagemagick.org/script/convert.php


On Thu, Oct 13, 2022 at 3:49 AM  wrote:

> There is also Kroki: https://kroki.io/
> It does the rendering of multiple text based diagram languages, including
> PlantUML, Mermaid, Ditaa and a bunch of others.
> Then you only need one tool for it.
>
> Best regards,
>
> Jan
>
> > -Original Message-
> > From: devel  On Behalf Of Chris Johns
> > Sent: Thursday, October 13, 2022 6:22 AM
> > To: Sam Price 
> > Cc: Development 
> > Subject: Re: docs not building to PDF
> >
> > On 13/10/2022 3:15 pm, Sam Price wrote:
> > > Yes
> > > https://github.com/mermaid-js/mermaid-cli
> > > <https://github.com/mermaid-js/mermaid-cli>
> > >
> > > There are command line tools so it can be integrated into pipelines.
> > >
> > >
> > >   Convert Mermaid mmd Diagram File To SVG
> > >
> > > mmdc -i input.mmd -o output.svg
> > >
> > >
> > >
> > > <https://github.com/mermaid-js/mermaid-cli#create-a-png-with-a-dark-
> > th
> > > eme-and-transparent-background>Create A PNG With A Dark Theme And
> > > Transparent Background
> > >
> > > mmdc -i input.mmd -o output.png -t dark -b transparent
> > >
> > > You dont get much control though over how it places boxes. But it does
> > > sequence diagrams.
> > > Im using it for gantt charts.
> > >
> > > Its one of the mainstream alternatives to plantuml
> > >
> >
> > This tool looks really good and it fits the pattern of tools we can use.
> >
> > Thanks for this.
> > Chris
> > ___
> > devel mailing list
> > devel@rtems.org
> > http://lists.rtems.org/mailman/listinfo/devel
>
-- 
Sincerely,

Sam Price
___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: docs not building to PDF

2022-10-13 Thread Frank Kühndel 

Hello Sam,
Hello Chris,

Sam, your mermaid diagram misses only yet another loop. Beside of that 
it looks really good and impressing. I like it very much. Many thanks 
for your efforts and help.


Unfortunately, I made (yet another) mistake and did not recognize that 
you already reproduced my diagram before I went through all the efforts 
to produce an own new graphic and put it into a patch. I apologize that 
I do not use your image. I simply have the patch ready now and do not 
want to start over again.


Chris, I created a ditaa diagram as you suggested but in the end I 
figured that it misinterprets the "=", "|" and "*" characters in the 
text. I do not know how that can be prevented. I tried to replace them 
by similar looking Unicode. That worked fine on OpenSUSE but failed (as 
I presumed) on FreeBSD.


My current solution is an activity diagram in plantuml. Hopefully this 
solution is acceptable. I will send the patch to the mailing list next.


Greetings
Frank

On 10/13/22 07:19, Sam Price wrote:

Subject:
Re: docs not building to PDF
From:
Sam Price 
Date:
10/13/22, 07:19

To:
Chris Johns 
CC:
Frank Kühndel , Thomas Doerfler 
, Development 



I forgot the loop backs. from close back to open.

On Thu, Oct 13, 2022 at 1:12 AM Chris Johns  wrote:


On 13/10/2022 4:06 pm, Sam Price wrote:

example



https://mermaid.live/edit#pako:eNqFVG1vmzAQ_iuWP6UVaZM0DQGlkSYlnSJ1bUUyddmYkAlmYQEbGVP6sv732cdrtSrj0z0v9p19h1_xjgcU2ziTRNJFRH4JkvQfRy5zWcQi6WeBjVYqiEgcvVAUR76iSu2WyoKLwzu94lyWHBaRsNGOs0yi3Z4IdJrwnEkv5RGT6Aq5-FyGMnXxzBfnc0GzPNZ0cggi0UMdr4HW3sp5-PYV_amiz010dwKrdbWwAnK2e2mqh8CC9OdiFxsN7OZoSGez_LL2rlc3y_V2rWJvs71fepvrzf36iMlZflp4D85qs2xNLvZjvjtk6lquhoPR2CgiFvAC8Nh4pMLnGXVxWd6JPgJPKRPcRmGgitegh1Ii9wa685zF3e3NFimboES1xH-WNFMujXpqgYECIonn52FIhaHT6zw87HV5dFJvsItV7s5NAdb7aIPOXHxYxYNTV1GISNK2DIBtHQZkb3xHs-XQho6as6pv3XnRdSfBu-4C_sflMji8nmYUqkn0ynA202A-L2WEfpz-RP3-HFUzXtMVbKRmnFu5osACQ16LAEq6GsVGqTCIbVG1fIyBJeVc1GKJQNCtrGkdHyfh2rsKECCXTTiSvuhmL4CG1tY0gP_S7ypomQ9KKLOXnGreb9XetnkVDefSQ4ANnFCRkChQD9mrdrlY7mmi_i5bhQENiRoZ9fOzN2UlueTrZ7bDthQ5NXCeBu3Th-2QxJliU8K-c57UJgWx_YqfsD0cDs6soXk5mlyMR2PTmkwN_Kzo0dn4cmxZg4FlTqeTifVm4BfYQNkvLNMyzUvLvJhMp6b59hcqM78E
<
https://mermaid.live/edit#pako:eNqFVG1vmzAQ_iuWP6UVaZM0DQGlkSYlnSJ1bUUyddmYkAlmYQEbGVP6sv732cdrtSrj0z0v9p19h1_xjgcU2ziTRNJFRH4JkvQfRy5zWcQi6WeBjVYqiEgcvVAUR76iSu2WyoKLwzu94lyWHBaRsNGOs0yi3Z4IdJrwnEkv5RGT6Aq5-FyGMnXxzBfnc0GzPNZ0cggi0UMdr4HW3sp5-PYV_amiz010dwKrdbWwAnK2e2mqh8CC9OdiFxsN7OZoSGez_LL2rlc3y_V2rWJvs71fepvrzf36iMlZflp4D85qs2xNLvZjvjtk6lquhoPR2CgiFvAC8Nh4pMLnGXVxWd6JPgJPKRPcRmGgitegh1Ii9wa685zF3e3NFimboES1xH-WNFMujXpqgYECIonn52FIhaHT6zw87HV5dFJvsItV7s5NAdb7aIPOXHxYxYNTV1GISNK2DIBtHQZkb3xHs-XQho6as6pv3XnRdSfBu-4C_sflMji8nmYUqkn0ynA202A-L2WEfpz-RP3-HFUzXtMVbKRmnFu5osACQ16LAEq6GsVGqTCIbVG1fIyBJeVc1GKJQNCtrGkdHyfh2rsKECCXTTiSvuhmL4CG1tY0gP_S7ypomQ9KKLOXnGreb9XetnkVDefSQ4ANnFCRkChQD9mrdrlY7mmi_i5bhQENiRoZ9fOzN2UlueTrZ7bDthQ5NXCeBu3Th-2QxJliU8K-c57UJgWx_YqfsD0cDs6soXk5mlyMR2PTmkwN_Kzo0dn4cmxZg4FlTqeTifVm4BfYQNkvLNMyzUvLvJhMp6b59hcqM78E


SVG link


https://mermaid.ink/svg/pako:eNqFVG1v2jAQ_iuWP0GVtrxDIoo0CTohdaUCJsaWKXKIMzKIjRynKWX899mXV7SK5dM9L_adfRef8IZ7FFs4kkTScUB-CRLevrZsZrOABdKNPAtNVRCQffBO0T5wFZVqz1QmXOwu9IyzWbgbB8JCG84iiTZbItBNyGMmnQMPmEQPyMb30pcHGw9dcT8SNIr3mg53XiBqqOI10MKZzlffvqI_WfS5iGZ1WK2rhRWQs9xLUzUEFqQ_G9vYKGA1R0HOl5MvC-dx-jRZrBcqdpbrl4mzfFy-LK6Y5pNPY2c1ny4npcnG7p5vdpG6lodmo9UxkoB5PAHcMV6pcHlEbZyWV9dH4AfKBLeQ76niNaihA5FbA82c-Xj2_LRGyiYoUS1xj5JGyqVRTS0wkEckcdzY96kwdHqdh_u1Ko_q-QabvcpduSnAeh9t0JmTD6tYzfMqEhFIWpYBsKzDgOyF72q2GNpQUWOW9a06L7ru0LvoLuB_XDaDw-tpRr6aRCcNh0MNRqNURujHzU90eztC2YzndAYLqRjnUs4osMCQ5yKAlM5GsVAyDGJZVC5fY2BJOhe5mCIQdCtzWsfXSbj2qgIEyGkTrqRPqtkToKG1OQ3gv_RFBSXzQQlp9pRTzfut2ls2L6PhXHoIsIFDKkISeOohO2mXjeWWhurvslToUZ-okVE_PzsrK4klXxzZBltSxNTA8cErn76cPBD2nfMqxNYJv2Gr2Wzcmc1-t9Vrd1qdvtkbGPio6NZdp9sxzUbD7A8GvZ55NvA7bKDsbbNv9vtds9HtNcxm-_wXZ4G-ow
<
https://mermaid.ink/svg/pako:eNqFVG1v2jAQ_iuWP0GVtrxDIoo0CTohdaUCJsaWKXKIMzKIjRynKWX899mXV7SK5dM9L_adfRef8IZ7FFs4kkTScUB-CRLevrZsZrOABdKNPAtNVRCQffBO0T5wFZVqz1QmXOwu9IyzWbgbB8JCG84iiTZbItBNyGMmnQMPmEQPyMb30pcHGw9dcT8SNIr3mg53XiBqqOI10MKZzlffvqI_WfS5iGZ1WK2rhRWQs9xLUzUEFqQ_G9vYKGA1R0HOl5MvC-dx-jRZrBcqdpbrl4mzfFy-LK6Y5pNPY2c1ny4npcnG7p5vdpG6lodmo9UxkoB5PAHcMV6pcHlEbZyWV9dH4AfKBLeQ76niNaihA5FbA82c-Xj2_LRGyiYoUS1xj5JGyqVRTS0wkEckcdzY96kwdHqdh_u1Ko_q-QabvcpduSnAeh9t0JmTD6tYzfMqEhFIWpYBsKzDgOyF72q2GNpQUWOW9a06L7ru0LvoLuB_XDaDw-tpRr6aRCcNh0MNRqNURujHzU90eztC2YzndAYLqRjnUs4osMCQ5yKAlM5GsVAyDGJZVC5fY2BJOhe5mCIQdCtzWsfXSbj2qgIEyGkTrqRPqtkToKG1OQ3gv_RFBSXzQQlp9pRTzfut2ls2L6PhXHoIsIFDKkISeOohO2mXjeWWhurvslToUZ-okVE_PzsrK4klXxzZBltSxNTA8cErn76cPBD2nfMqxNYJv2Gr2Wzcmc1-t9Vrd1qdvtkbGPio6NZdp9sxzUbD7A8GvZ55NvA7bKDsbbNv9vtds9HtNcxm-_wXZ4G-ow



I couldn't figure out how to get semi colons to work
new lines are kind  of a pain also.

You are a legend (pun intended) :D

It is looking goo but Frank has the final say.

Chris


stateDiagram-v2

initbsd:Initialize libbsd
initNe