[MERGE] Don't generate .html files for .txt's that are transcluded

[John Arbash Meinel]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Alexander Belchenko wrote:
> Eric Siegerman пишет:
>> On Wed, 2009-03-25 at 14:01 -0400, Eric Siegerman wrote:
>>> Is it better to add index entries for HTML files [that are not
>>> linked-to but rather transcluded], or to stop
>>> generating them on the theory that they're not standalone
>>> documents, but merely fragments of a larger one?
>> On further reflection, I went ahead and did the latter.  (It's
>> easy enough to bb:reject this if I made the wrong choice :-))
>>
>>   - Eric
>>
> Couple years ago similar patch of mine was rejected.

I don't remember the specifics, but what is written here seems fine.
Specifically, he has a list of *excluded* files, rather than a list of
*included* files.

Which means that just writing a .txt file in doc/developers/* means that
it will get generated into .html, unless you explicitly exclude it.
Having it the other way means that when you write a .txt file, you have
to go back and remember to update the Makefile as well.

So while I don't feel there is any harm in generating the .html (is
there a reason you feel it should be omitted?), at least this doesn't
add extra burden for writers to update a list in the common case.

John
=:->

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Cygwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAknL3/gACgkQJdeBCYSNAAP4tACgi5Ic2BSus4kWEXwdf8f5FJpj
gxMAnR8kTiWqAJvT09Jr8UeMghzyB1by
=Aa6N
-----END PGP SIGNATURE-----