Path: csiph.com!au2pb.net!feeder.erje.net!1.eu.feeder.erje.net!newsfeed.fsmpi.rwth-aachen.de!newsfeed.straub-nv.de!eternal-september.org!feeder.eternal-september.org!mx02.eternal-september.org!.POSTED!not-for-mail
From: Keith Thompson <kst-u@mib.org>
Newsgroups: comp.lang.c
Subject: Re: // comments and \
Date: Sun, 06 Dec 2015 12:22:27 -0800
Organization: None to speak of
Lines: 22
Message-ID: <lnoae3pbss.fsf@kst-u.example.com>
References: <n3k52h$cjq$1@dont-email.me> <n3k6n9$jgt$1@dont-email.me> <n3k7or$gaf$1@speranza.aioe.org> <1by4dedxvd.fsf@pfeifferfamily.net> <874mg2dwm9.fsf@bsb.me.uk> <1btwo2dw6b.fsf@pfeifferfamily.net> <n3keip$itf$1@dont-email.me> <1bh9k2dtri.fsf@pfeifferfamily.net> <n3kig7$2bg$1@dont-email.me> <slrnn5s1j0.5q5.grahn+nntp@frailea.sa.invalid> <n3l1rv$47l$1@dont-email.me> <MPG.30c87207646df0d3ba@news.eternal-september.org> <n3mltr$6ti$1@dont-email.me> <n3mpk4$knk$1@dont-email.me> <slrnn5udqn.5q5.grahn+nntp@frailea.sa.invalid> <n3p9rq$akb$1@dont-email.me> <slrnn661uj.5q5.grahn+nntp@frailea.sa.invalid> <n3v62a$fj3$1@dont-email.me> <slrnn681si.5q5.grahn+nntp@frailea.sa.invalid> <07cfc60c-f1ec-46e5-b8f7-3fe837116a6a@googlegroups.com> <slrnn68fq4.5q5.grahn+nntp@frailea.sa.invalid>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Injection-Info: mx02.eternal-september.org; posting-host="945944de09706c9b4e29b53c9d2efdc2"; logging-data="23714"; mail-complaints-to="abuse@eternal-september.org";	posting-account="U2FsdGVkX19A8SniIUF6mEX3tqSqoJB2"
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1 (gnu/linux)
Cancel-Lock: sha1:OFl1AjZLUsNir6f1T3V0gwvzFJU= sha1:8ZxrYQu6cBZngMThl1MnY5fHlnQ=
Xref: csiph.com comp.lang.c:77994

Jorgen Grahn <grahn+nntp@snipabacken.se> writes:
[...]
> It's unclear to me why people put generated things in version control,
> but it seems to happen over and over again.  I've certainly seen it
> myself.
[...]

I prefer not to do this, but I've recently had a case where it
made sense.

A project had documentation that was generated from an input file
in Markdown format.  The Makefile created files in man page and
PDF formats, but it required tools that other users might not
have installed, so I added the generated files to the repository.
It does make things a little more complicated, but it makes the
human-readable documentation more easily available to other users.

-- 
Keith Thompson (The_Other_Keith) kst-u@mib.org  <http://www.ghoti.net/~kst>
Working, but not speaking, for JetHead Development, Inc.
"We must do something.  This is something.  Therefore, we must do this."
    -- Antony Jay and Jonathan Lynn, "Yes Minister"