summaryrefslogtreecommitdiff
path: root/NOTES.podchecker
blob: 57fc320d8cb61d487d59e627192a074f5a453fde (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
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.