Generate Markdown from all .pod and .dbd.pod files

Co-authored-by: Timo Korhonen <timo.korhonen@ess.eu>

documentation/Makefile

@@ -8,6 +8,7 @@ EXPAND_ME += EPICS_MODIFICATION
 EXPAND_ME += EPICS_PATCH_LEVEL
 EXPAND_ME += OS_CLASS CMPLR_CLASS
 
+MARKDOWNS += ComponentReference.md
 HTMLS += ComponentReference.html
 
 TARGETS += doxygen

modules/database/src/ioc/bpt/Makefile

@@ -28,5 +28,5 @@ PROD_HOST += makeBpt
 
 makeBpt_SRCS = makeBpt
 
+DOCS += menuConvert.md
 HTMLS += menuConvert.html
-

modules/database/src/ioc/db/Makefile

@@ -61,6 +61,12 @@ DBDINC += menuScan
 DBDINC += dbCommon
 
 dbMenusPod = $(notdir $(wildcard ../db/menu*.dbd.pod))
+
+DOCS += $(patsubst %.dbd.pod,%.md,$(dbMenusPod))
+DOCS += dbCommonRecord.md
+DOCS += dbCommonInput.md
+DOCS += dbCommonOutput.md
+
 HTMLS += $(patsubst %.dbd.pod,%.html,$(dbMenusPod))
 HTMLS += dbCommonRecord.html
 HTMLS += dbCommonInput.html

modules/database/src/ioc/db/menuYesNo.dbd.pod

@@ -17,7 +17,8 @@ C<MAYBE> or C<NO WAY> would not be accepted as choices for the field.
 Also, the choices C<yes>, C<No>, and C<Yes> are not valid choices since they
 don't match the case of C<NO> or C<YES>.
 The integer values C<0> and C<1> may often be used instead however, they are
-used as an index into the choices so C<0> becomes C<NO> and C<1> becomes <YES>.
+used as an index into the choices so C<0> becomes C<NO> and C<1> becomes
+C<YES>.
 
 =menu menuYesNo
 

modules/database/src/std/filters/Makefile

@@ -18,5 +18,5 @@ dbRecStd_SRCS += sync.c
 dbRecStd_SRCS += decimate.c
 dbRecStd_SRCS += utag.c
 
+DOCS += filters.md
 HTMLS += filters.html
-

modules/database/src/std/link/Makefile

@@ -16,4 +16,5 @@ dbRecStd_SRCS += lnkCalc.c
 dbRecStd_SRCS += lnkState.c
 dbRecStd_SRCS += lnkDebug.c
 
+DOCS += links.md
 HTMLS += links.html

modules/database/src/std/rec/Makefile

@@ -54,8 +54,13 @@ stdRecords_DBD = $(patsubst %,%.dbd,$(stdRecords))
 
 dbRecStd_SRCS += $(patsubst %,%.c,$(stdRecords))
 
+DOCS += $(patsubst %.dbd.pod,%.md,$(notdir $(wildcard ../rec/*Record.dbd.pod)))
 HTMLS += $(patsubst %.dbd.pod,%.html,$(notdir $(wildcard ../rec/*Record.dbd.pod)))
 
 vpath %.png $(SRC_DIRS)
+
+DOCS += image/compress-1.png
+DOCS += image/compress-2.png
+
 HTMLS += image/compress-1.png
 HTMLS += image/compress-2.png

src/tools/Makefile

@@ -61,4 +61,8 @@ HTMLS += podToHtml.html
 HTMLS += podToMD.html
 HTMLS += podRemove.html
 
+# The above Perl program documentation (modelled after Man pages)
+# doesn't work well in Doxygen's "Related Pages" area, the titles
+# for all doc's are "NAME", so don't convert these to Markdown.
+
 include $(TOP)/configure/RULES