summaryrefslogtreecommitdiff
path: root/NOTES.podchecker
diff options
context:
space:
mode:
authorSean Whitton <spwhitton@spwhitton.name>2018-11-17 11:00:54 -0700
committerSean Whitton <spwhitton@spwhitton.name>2018-11-17 11:00:54 -0700
commitfde00691054302b53783d14880ef015e8f81758b (patch)
tree323aae3f069791b9b9966ffdbf8fe3f5fc979cd6 /NOTES.podchecker
parent43faee259ac0418b98f0c973a794c21f47c9d1c1 (diff)
parentbfb113c41cdc9bc875cec6f1c24f930e664e853e (diff)
Merge tag 'debian/8.1' into stretch-bpo
dgit release 8.1 for unstable (sid) [dgit] [dgit distro=debian] # gpg: Signature made Wed 07 Nov 2018 07:11:36 PM MST # gpg: using RSA key 559AE46C2D6B6D3265E7CBA1E3E3392348B50D39 # gpg: Can't check signature: No public key
Diffstat (limited to 'NOTES.podchecker')
-rw-r--r--NOTES.podchecker27
1 files changed, 27 insertions, 0 deletions
diff --git a/NOTES.podchecker b/NOTES.podchecker
new file mode 100644
index 0000000..57fc320
--- /dev/null
+++ b/NOTES.podchecker
@@ -0,0 +1,27 @@
+todo: maybe we wanted to run podchecker but it complains about a lot
+of things for which we don't have good alternatives. Eg:
+
+
+*** WARNING: (section) in 'dgit-maint-debrebase(7)' deprecated at line 17 in file ../git-debrebase.1.pod
+
+ But this is not actually described as deprecated and how else to
+ write a manpage cross-reference ? Maybe this warning applies
+ only to perl's own manpages.
+
+*** WARNING: 2 unescaped <> in paragraph at line 30 in file ../git-debrebase.1.pod
+
+ I have a habit of writing things like
+ git-debrebase [-- <git-rebase options...>]
+ which is obviously unescaped < but the E<> syntax would be awful
+
+*** WARNING: No items in =over (at line 31) / =back list at line 42 in file ../dgit-user.7.pod
+*** WARNING: No argument for =item at line 553 in file ../git-debrebase.1.pod
+
+ pod doesn't offer a better answer, and these render well
+
+*** ERROR: unresolved internal link 'dgit-maint-*(7)' at line 22 in file ../dgit-user.7.pod
+
+ This is obviously needed.
+
+At the time of writing it does not seem to detect anything which
+generates bad rendering. So for now I will not run it.