<div dir="auto"><div><br><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Oct 7, 2020, 8:12 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">On 8/10/20 12:04 pm, Joel Sherrill wrote:<br>
> On Wed, Oct 7, 2020, 8:01 PM Chris Johns <<a href="mailto:chrisj@rtems.org" target="_blank" rel="noreferrer">chrisj@rtems.org</a><br>
> <mailto:<a href="mailto:chrisj@rtems.org" target="_blank" rel="noreferrer">chrisj@rtems.org</a>>> wrote:<br>
> <br>
>     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>
> <br>
> <br>
> Graphviz. <br>
<br>
Thanks but I was hoping for something a little more specific, like a `pkg<br>
install ...` command and a command line to run. I think it is important when<br>
wanting to maintaining quality. :)<br></blockquote></div></div><div dir="auto"><br></div><div dir="auto">That is the name of the package. May vary with upper or lower case. CentOS RPM is graphviz.</div><div dir="auto"><br></div><div dir="auto">Are there any figures we do not appear to have source for? Or they aren't in an open format? I thought we had killed all those in our last Google Code In.</div><div dir="auto"><br></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>
> <br>
> If you can build Doxygen with graphics, you should have dot. We want dot for sure.<br>
> <br>
<br>
Sure, happy to be dot source integrated and managed.<br></blockquote></div></div><div dir="auto"><br></div><div dir="auto">I surprised one of my sons by using dot to show them the dependency graph for them to graduate on time. Coloured nodes based on semester offered and could visually identify longest sequence of courses and which had no prerequisites left for him.</div><div dir="auto"><br></div><div dir="auto">PlantUML can draw more types of figures and they often look better but it can embed dot.</div><div dir="auto"><br></div><div dir="auto">--joel</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>
Chris<br>
<br>
> <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> <mailto:<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>
> <br>
</blockquote></div></div></div>