Conversion text in documentation

--0000000000004915a805cf328c25
Content-Type: text/plain; charset="UTF-8"

Hello,

I'm Andrea Tosoni.

Some years ago I started to write some perl scripts because I don't like to
re-made the same thing many times, especially when I have to write
documentation (I'm a hardware designer).

In these years, scripts have become perl modules that work almost fine.

I started from POD idea: merge code and documentation. I added the
possibility to load parameters from an external file or by constants
defined in my code (VHDL or Verilog or some other language). I can also
calculate fields and iterate on lists or similar basic programming
operations.The markup is very easy. Documentation can be split in many
source files without order and it's merged at the end.

I also added the possibility to load images (vectorial images for the
moment) and create tables.

Today my output is a Framemaker file (in my company it is the tool for
official documentation) but I think to add the possibility to export in
Latex (because I like) and Word (because I have to support it).

I don't know if these modules can help somebody else.

Today I have to rework to remove deprecated modules, increase test coverage
and add some missing functionalities and this can be the moment to
organize in official modules, if you think that can be useful.

Thank you for reading my mail.

Best regards,

                        Andrea Tosoni

--0000000000004915a805cf328c25
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">Hello,<div><br></div><div>I&#39;m Andrea Tosoni.</div><div=
><br></div><div>Some years ago I started to write some perl scripts because=
 I don&#39;t like to re-made the same thing many times, especially when=C2=
=A0I have to write documentation (I&#39;m a hardware designer).</div><div><=
br></div><div>In these years, scripts have become perl modules that work=C2=
=A0almost fine.</div><div><br></div><div>I started from POD idea: merge cod=
e and documentation. I added the possibility to load parameters from an ext=
ernal file or by constants defined in my code (VHDL or Verilog or some othe=
r language). I can also calculate fields and iterate on lists or similar ba=
sic programming operations.The markup is very easy. Documentation can be sp=
lit in many source files without order and it&#39;s merged at the end.</div=
><div><br></div><div>I also added the possibility to load images (vectorial=
 images for the moment) and create tables.</div><div><br></div><div>Today m=
y output is a Framemaker file (in my company it is the tool for official do=
cumentation) but I think to add the possibility to export in Latex (because=
 I like) and Word (because I have to support it).</div><div><br></div><div>=
I don&#39;t know if these modules can help somebody else.</div><div><br></d=
iv><div>Today I have to rework to remove deprecated modules, increase test =
coverage and add some missing functionalities=C2=A0and this can be the mome=
nt to organize=C2=A0in official modules, if you think that can be useful.</=
div><div><br></div><div>Thank you for reading my mail.</div><div><br></div>=
<div>Best regards,</div><div><br></div><div>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 Andrea Tosoni</div><di=
v><br></div><div><br></div><div><br></div><div><br></div></div>

--0000000000004915a805cf328c25--