SubmittingPatches: mention doc-diff
We already advise people to make sure their documentation formats correctly. Let's point them at the doc-diff script, which can help with that. Let's also put a brief note in the script about its purpose, since that otherwise can only be found in the original commit message. Along with the existing -h/usage text, that's hopefully enough for developers to make use of it. Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:

committed by
Junio C Hamano

parent
beb188e22a
commit
7a76f5c611
@ -1,4 +1,12 @@
|
||||
#!/bin/sh
|
||||
#
|
||||
# Build two documentation trees and diff the resulting formatted output.
|
||||
# Compared to a source diff, this can reveal mistakes in the formatting.
|
||||
# For example:
|
||||
#
|
||||
# ./doc-diff origin/master HEAD
|
||||
#
|
||||
# would show the differences introduced by a branch based on master.
|
||||
|
||||
OPTIONS_SPEC="\
|
||||
doc-diff [options] <from> <to> [-- <diff-options>]
|
||||
|
Reference in New Issue
Block a user