Re: What's cooking in git.git (Jul 2014, #04; Tue, 22)

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



From: "Junio C Hamano" <gitster@xxxxxxxxx>
Sent: Wednesday, July 23, 2014 7:10 PM
"Philip Oakley" <philipoakley@xxxxxxx> writes:

* po/everyday-doc (2014-01-27) 1 commit
- Make 'git help everyday' work

This may make the said command to emit something, but the source is
not meant to be formatted into a manual pages to begin with, and
also its contents are a bit stale.

It may be a good first step in
the right direction, but needs more work to at least get the
mark-up right before public consumption.

Will hold.


It's not clear to me which bits of mark-up are 'wrong' and must be
reworked,

It's been too long since I wrote the above and I left it without
updates (these comments are by default carried over from one issue
to the next of "What's cooking" report, unless there is some
development on the topic).  Now I read the output (admittedly, I
skimmed only the HTML version), I think the formatting / mark-up is
fine.

Thanks for the clarification - I hadn't been sure which way to go on the formatting aspect.

I at the same time found various command sequences used there are
rather classical and there are better ways to do the same with
modern tools,

I can have a look at the 'standalone' and 'participant' developer command lists but would shy away from any claims about the 'integrator' and 'administrator' roles ;-)

which still makes me feel hesitant to promote this
document without updating its contents, though.


I hadn't viewed it as a 'promotion', rather it was simply ensuring access to the guide via the help system, instead of leaving it somewhat hidden.

--
Philip
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]