Re: a new release

Derek Robert Price <[email protected]> Wed, 24 Sep 2003 01:06:11 -0400
Newsgroups gmane.comp.tex.texi2html.devel
Organization Ximbiot <http://ximbiot.com>
Message-ID <[email protected]>
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Dumas Patrice wrote:

|>|I have seen your NEWS file and the cvs NEWS file. I will expand with my
|>|changes.
|
|
|I expanded a lot, but I still have questions.
|
|* You refer to some documentation in NEWS about translation strings format,
|but this documentation isn't allready written...
|I would be happy to do it, but I think that first the changes I made in
|the manual should be accepted or rejected, such that there isn't unusefull
|work done. More reference to the documentation could be done, but it still
|requires an update of the manual.


I won't be too picky about requiring this for the release.  We can
change the NEWS file to read something like, see the i18n/* files for
examples.

When you're ready to do doc, you can send me patches and I can go over
them and correct your English and commit them, if that's what you mean,
though your English is pretty good.  I've certainly seen much worse, and
in open source manuals.  :)

|* should I document the changes I maid


Not, "maid", in this sense.  It's "made".  Maids clean up after people.
:)  The pronunciation is the same.

| in hashes which appeared in the
|texi2html.pl in the last release ? (%style_map, $complex_format_map...).
|I just mentionned the changes done in things which were in the
texi2html.init
|file.


If it's not something a non-developer would touch, I wouldn't worry
about it.  Implementation details should be left out of the NEWS file.
The NEWS file is intended for users, not developers.

As far as other developers are concerned, there aren't many of us and
the mailing list, the ChangeLog, and CVS commands will probably do the
trick.  If you really think those sources won't be sufficient, you could
always create a DEVELOPER-NEWS file or the like.

Derek

- --
~                *8^)

Email: [email protected]

Get CVS support at <http://ximbiot.com>!
- --
BUFFERS=20 FILES=15 2nd down, 4th quarter, 5 yards to go!
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (GNU/Linux)
Comment: Using GnuPG with Netscape - http://enigmail.mozdev.org

iD8DBQE/cSZCLD1OTBfyMaQRAg7IAJ49da5YGjkGY1s9byGJi1M4bCs/GgCgkTrL
EjG9J65PMkBVO4G7Jk/bOkk=
=Wcnm
-----END PGP SIGNATURE-----