<div dir="auto"><div><br><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Oct 7, 2020, 8:01 PM Chris Johns <<a href="mailto:chrisj@rtems.org">chrisj@rtems.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi,<br>
<br>
In an update of my rtems-docs.git repo I noticed some new image source formats:<br>
<br>
$ find . -name \*.dot<br>
./images/eng/bld-bsp.dot<br>
./images/eng/bld-deps2.dot<br>
./images/eng/bld-bsp2.dot<br>
./images/eng/bld-deps.dot<br>
<br>
Do we have a policy on what image source types can be used? Any additional image<br>
source needs to support FreeBSD and Linux.<br>
<br>
Images can be difficult to get right so I understand there is a need for<br>
flexibility and tolerance but I think we need to consider how we manage the<br>
process and quality so we maintained high quality documentation. For example on<br>
my desktop I cannot read the HTML `bld-deps.png` and clicking on it loads a<br>
small image which is clearer but small. The page is ...<br>
<br>
<a href="https://docs.rtems.org/branches/master/eng/build-system.html#build-specification-items" rel="noreferrer noreferrer" target="_blank">https://docs.rtems.org/branches/master/eng/build-system.html#build-specification-items</a><br>
<br>
The PDF view looks OK.<br>
<br>
I can see we have as image source the following extensions:<br>
<br>
 .puml<br>
 .ditaa<br>
 .svg<br>
 .dot<br>
 .odg<br>
<br>
Some formats are old and imported so we live with those but maybe we need<br>
tickets to have them move to something that is simpler to maintain.<br>
<br>
I see generated .png and .pdf for some images which I am questioning we need.<br>
The user document images I have contributed are only .png files so I am not sure<br>
why a PDF is needed for some.<br>
<br>
How are the .dot image sources converted to the required output format(s)? I<br>
cannot see any information on what to do, what packages I need to install and<br>
the options I need. For the puml and ditaa source I contributed I added waf<br>
support, tested on Linux and FreeBSD and update the top level doco.<br></blockquote></div></div><div dir="auto"><br></div><div dir="auto">Graphviz. </div><div dir="auto"><br></div><div dir="auto">If you can build Doxygen with graphics, you should have dot. We want dot for sure.</div><div dir="auto"><br></div><div dir="auto"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Sorry to be a pain about this but I think it is better we sort this out before<br>
we all move on and forget how they are created.<br>
<br>
Chris<br>
_______________________________________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" target="_blank" rel="noreferrer">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a><br>
</blockquote></div></div></div>