mcs/tools/mdoc/Makefile

   1 thisdir = tools/mdoc
   2 SUBDIRS =
   3 include ../../build/rules.make
   4
   5 MDOC_COMMON_FLAGS = \
   6         /resource:../../class/monodoc/Resources/mdoc-html-format.xsl,mdoc-html-format.xsl    \
   7         /resource:../../class/monodoc/Resources/mdoc-html-utils.xsl,mdoc-html-utils.xsl      \
   8         /resource:../../class/monodoc/Resources/mdoc-sections-css.xsl,mdoc-sections-css.xsl  \
   9         /resource:../../class/monodoc/Resources/mono-ecma-css.xsl,mono-ecma-css.xsl          \
  10         /resource:Resources/defaulttemplate.xsl,defaulttemplate.xsl                 \
  11         /resource:Resources/monodoc-ecma.xsd,monodoc-ecma.xsd                       \
  12         /resource:Resources/msitomsx.xsl,msitomsx.xsl                               \
  13         /resource:Resources/overview.xsl,overview.xsl                               \
  14         /resource:Resources/stylesheet.xsl,stylesheet.xsl                           \
  15         /r:System.Web.dll                                                           \
  16         /r:System.Xml.Linq.dll                                                      \
  17         /r:ICSharpCode.SharpZipLib.dll                                              \
  18         /r:Mono.Cecil.dll
  19
  20 LOCAL_MCS_FLAGS = $(MDOC_COMMON_FLAGS) \
  21         /r:monodoc.dll
  22 PROGRAM = mdoc.exe
  23 PROGRAM_DEPS = $(topdir)/class/lib/$(PROFILE)/monodoc.dll
  24
  25 ifdef NET
  26 all : copy-with-deps
  27
  28 copy-with-deps:
  29         -mkdir mdoc-net
  30         cp $(PROGRAM) mdoc-net
  31         cp $(topdir)/class/lib/$(PROFILE)/Commons.Xml.Relaxng.dll mdoc-net
  32         cp $(topdir)/class/lib/$(PROFILE)/ICSharpCode.SharpZipLib.dll mdoc-net
  33         cp $(topdir)/class/lib/$(PROFILE)/Mono.Cecil.dll mdoc-net
  34         cp $(topdir)/class/lib/$(PROFILE)/monodoc.dll mdoc-net
  35 endif
  36
  37 MONODOC_RESOURCES = \
  38         ../../class/monodoc/Resources/mdoc-html-utils.xsl    \
  39         ../../class/monodoc/Resources/mdoc-sections-css.xsl  \
  40         ../../class/monodoc/Resources/mono-ecma-css.xsl
  41
  42 MDOC_RESOURCES = \
  43         Resources/defaulttemplate.xsl     \
  44         Resources/monodoc-ecma.xsd        \
  45         Resources/msitomsx.xsl            \
  46         Resources/overview.xsl            \
  47         Resources/stylesheet.xsl
  48
  49 MDOC_TEST_FILES = \
  50         Test/DocTest-v1.cs                                        \
  51         Test/DocTest-v2.patch                                     \
  52         Test/msxdoc-expected.importslashdoc.xml                   \
  53         Test/TestEcmaDocs.xml                                     \
  54         Test/validate.check.monodocer                             \
  55         Test/validate.check.monodocer.importslashdoc              \
  56         Test/validate.check.monodocer.since
  57
  58 EXTRA_DISTFILES = \
  59         $(MDOC_RESOURCES) \
  60         $(MDOC_TEST_FILES)
  61
  62 $(PROGRAM) : $(MDOC_RESOURCES) $(MONODOC_RESOURCES) $(PROGRAM_DEPS)
  63
  64 include ../../build/executable.make
  65
  66 $(PROGRAM) : $(build_lib)
  67         cp $< $@
  68
  69 $(PROGRAM) : Makefile
  70
  71 MONO = \
  72         MONO_PATH="$(topdir)/class/lib/$(PROFILE)$(PLATFORM_PATH_SEPARATOR)$$MONO_PATH" \
  73         $(RUNTIME) $(RUNTIME_FLAGS)
  74
  75 dist-local: dist-default dist-tests
  76
  77 dist-tests:
  78         find Test/en.expected* -name '*.xml'     > .files
  79         find Test/html.expected* -name '*.html' >> .files
  80         tar cTf .files - | (cd $(distdir); tar xf -)
  81         rm .files ; \
  82
  83 test-local: $(PROGRAM)
  84
  85 clean-local: cleanup
  86
  87 cleanup:
  88         -rm -Rf Test/en.actual Test/html.actual
  89         -rm -f monodocer1.exe*
  90
  91 Test/DocTest.dll:
  92         $(CSCOMPILE) $(TEST_CSCFLAGS) -debug -unsafe -target:library -out:$@ Test/DocTest.cs
  93
  94 Test/DocTest.dll-v1:
  95         -rm -f Test/DocTest.cs
  96         cp Test/DocTest-v1.cs Test/DocTest.cs
  97         -rm -f Test/DocTest.dll
  98         $(MAKE) TEST_CSCFLAGS=$(TEST_CSCFLAGS) Test/DocTest.dll
  99
 100 Test/DocTest.dll-v2:
 101         -rm -f Test/DocTest.cs
 102         cp Test/DocTest-v1.cs Test/DocTest.cs
 103         cd Test && patch -p0 < DocTest-v2.patch
 104         -rm -f Test/DocTest.dll
 105         $(MAKE) TEST_CSCFLAGS=$(TEST_CSCFLAGS) Test/DocTest.dll
 106
 107 check-monodocer-update: $(PROGRAM)
 108         find Test/en.expected -name \*.xml -exec rm "{}" \;
 109         $(MAKE) Test/DocTest.dll-v1
 110         $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.expected Test/DocTest.dll
 111
 112 check-monodocer: $(PROGRAM)
 113         -rm -Rf Test/en.actual
 114         $(MAKE) Test/DocTest.dll-v1
 115         $(MONO) $(PROGRAM) update --debug --exceptions=all -o Test/en.actual Test/DocTest.dll
 116         diff --exclude=.svn -rup Test/en.expected Test/en.actual
 117         $(MONO) $(PROGRAM) update --debug --exceptions=all -o Test/en.actual Test/DocTest.dll
 118         diff --exclude=.svn -rup Test/en.expected Test/en.actual
 119
 120 check-monodocer-since-update: $(PROGRAM)
 121         find Test/en.expected.since -name \*.xml -exec rm "{}" \;
 122         $(MAKE) Test/DocTest.dll-v1
 123         $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.expected.since Test/DocTest.dll
 124         $(MAKE) Test/DocTest.dll-v2
 125         $(MONO) $(PROGRAM) update --exceptions=all --since="Version 2.0" \
 126                 -o Test/en.expected.since Test/DocTest.dll
 127
 128 check-monodocer-since: $(PROGRAM)
 129         rm -Rf Test/en.actual
 130         $(MAKE) Test/DocTest.dll-v1
 131         $(MONO) $(PROGRAM) --debug update --exceptions=all -o Test/en.actual Test/DocTest.dll
 132         $(MAKE) Test/DocTest.dll-v2
 133         $(MONO) $(PROGRAM) --debug update --exceptions=all --since="Version 2.0" \
 134                 -o Test/en.actual Test/DocTest.dll
 135         diff --exclude=.svn -rup Test/en.expected.since Test/en.actual
 136
 137 check-monodocer-delete-update: $(PROGRAM)
 138         find Test/en.expected.delete -type f -exec rm "{}" \;
 139         $(MAKE) Test/DocTest.dll-v1
 140         $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.expected.delete Test/DocTest.dll
 141         $(MAKE) Test/DocTest.dll-v2
 142         $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.expected.delete Test/DocTest.dll
 143         $(MAKE) Test/DocTest.dll-v1
 144         $(MONO) $(PROGRAM) update -fno-assembly-versions --delete --exceptions=all \
 145                 -o Test/en.expected.delete Test/DocTest.dll
 146
 147 check-monodocer-delete: $(PROGRAM)
 148         rm -Rf Test/en.actual
 149         $(MAKE) Test/DocTest.dll-v1
 150         $(MONO) $(PROGRAM) --debug update --exceptions=all -o Test/en.actual Test/DocTest.dll
 151         $(MAKE) Test/DocTest.dll-v2
 152         $(MONO) $(PROGRAM) --debug update --exceptions=all -o Test/en.actual Test/DocTest.dll
 153         $(MAKE) Test/DocTest.dll-v1
 154         $(MONO) $(PROGRAM) --debug update -fno-assembly-versions --delete --exceptions=all -o Test/en.actual Test/DocTest.dll
 155         diff --exclude=.svn -rup Test/en.expected.delete Test/en.actual
 156
 157 check-monodocer-importslashdoc-update: $(PROGRAM)
 158         find Test/en.expected.importslashdoc -name \*.xml -exec rm "{}" \;
 159         $(MAKE) Test/DocTest.dll-v1 TEST_CSCFLAGS=-doc:Test/DocTest.xml
 160         $(MONO) $(PROGRAM) --debug update --exceptions=all -i Test/DocTest.xml \
 161                 -o Test/en.expected.importslashdoc Test/DocTest.dll
 162
 163 check-monodocer-importslashdoc: $(PROGRAM)
 164         rm -Rf Test/en.actual
 165         $(MAKE) Test/DocTest.dll-v1 TEST_CSCFLAGS=-doc:Test/DocTest.xml
 166         $(MONO) $(PROGRAM) --debug update --exceptions=all -i Test/DocTest.xml \
 167                 -o Test/en.actual Test/DocTest.dll
 168         diff --exclude=.svn -rup Test/en.expected.importslashdoc Test/en.actual
 169
 170 check-monodocer-importecmadoc-update: $(PROGRAM)
 171         find Test/en.expected.importecmadoc -name \*.xml -exec rm "{}" \;
 172         $(MAKE) Test/DocTest.dll-v1
 173         $(MONO) $(PROGRAM) --debug update --exceptions=all -i Test/TestEcmaDocs.xml \
 174                 '--type=System.Action`1' --type=System.AsyncCallback \
 175                 --type=System.Environment --type=System.Array \
 176                 -o Test/en.expected.importecmadoc Test/DocTest.dll
 177
 178 check-monodocer-importecmadoc: $(PROGRAM)
 179         rm -Rf Test/en.actual
 180         $(MAKE) Test/DocTest.dll-v1
 181         $(MONO) $(PROGRAM) --debug update --exceptions=all -i Test/TestEcmaDocs.xml \
 182                 '--type=System.Action`1' --type=System.AsyncCallback \
 183                 --type=System.Environment --type=System.Array \
 184                 -o Test/en.actual Test/DocTest.dll
 185         diff --exclude=.svn -rup Test/en.expected.importecmadoc Test/en.actual
 186
 187 check-mdoc-export-html-update: $(PROGRAM)
 188         find Test/html.expected -name \*.html -exec rm "{}" \;
 189         $(MONO) $(PROGRAM) export-html -o Test/html.expected \
 190                 Test/en.expected.importslashdoc
 191
 192 check-mdoc-export-html: check-monodocer $(PROGRAM)
 193         rm -Rf Test/html.actual
 194         $(MONO) $(PROGRAM) export-html -o Test/html.actual \
 195                 Test/en.expected.importslashdoc
 196         diff --exclude=.svn -rup Test/html.expected Test/html.actual
 197
 198 check-mdoc-export-html-with-version: $(PROGRAM)
 199         rm -Rf Test/html.actual.v0 Test/html.actual.since-with-v0 .v0.txt .v2.txt
 200         $(MONO) $(PROGRAM) export-html -o Test/html.actual.v0 \
 201                 Test/en.expected
 202         $(MONO) $(PROGRAM) export-html -o Test/html.actual.since-with-v0 \
 203                 Test/en.expected.since -with-version 0.0.0.0
 204         (cd Test/html.actual.v0            && find . -type f) | sort > .v0.txt
 205         (cd Test/html.actual.since-with-v0 && find . -type f) | sort > .v2.txt
 206         diff -rup .v0.txt .v2.txt   # assert no types added
 207
 208 check-md-html-dir: $(PROGRAM)
 209         rm -Rf Test/html.actual
 210         $(MONO) $(PROGRAM) export-html -dest:Test/html.actual $(DIR)
 211         diff --exclude=.svn -rup Test/html.expected Test/html.actual
 212
 213 check-mdoc-export-msxdoc-update:
 214         $(MONO) $(PROGRAM) export-msxdoc -o - Test/en.expected.importslashdoc \
 215                 > Test/msxdoc-expected.importslashdoc.xml
 216
 217 check-mdoc-export-msxdoc:
 218         $(MONO) $(PROGRAM) export-msxdoc -o - Test/en.expected.importslashdoc \
 219                 | diff --brief - Test/msxdoc-expected.importslashdoc.xml
 220
 221 my_abs_top_srcdir = $(shell cd . && pwd)
 222
 223 check-mdoc-validate-update: $(PROGRAM)
 224         $(MONO) $(PROGRAM) validate -f ecma Test/en.expected 2>&1 | \
 225                 sed 's#file://$(my_abs_top_srcdir)/##g' > \
 226                 Test/validate.check.monodocer
 227         $(MONO) $(PROGRAM) validate -f ecma Test/en.expected.importslashdoc 2>&1 | \
 228                 sed 's#file://$(my_abs_top_srcdir)/##g' > \
 229                 Test/validate.check.monodocer.importslashdoc
 230         $(MONO) $(PROGRAM) validate -f ecma Test/en.expected.since 2>&1 | \
 231                 sed 's#file://$(my_abs_top_srcdir)/##g' > \
 232                 Test/validate.check.monodocer.since
 233
 234 check-mdoc-validate: $(PROGRAM)
 235         $(MONO) $(PROGRAM) validate -f ecma Test/en.expected 2>&1 | \
 236                 sed 's#file://$(my_abs_top_srcdir)/##g' | \
 237                 diff - Test/validate.check.monodocer
 238         $(MONO) $(PROGRAM) validate -f ecma Test/en.expected.importslashdoc 2>&1 | \
 239                 sed 's#file://$(my_abs_top_srcdir)/##g' | \
 240                 diff --brief - Test/validate.check.monodocer.importslashdoc
 241         $(MONO) $(PROGRAM) validate -f ecma Test/en.expected.since 2>&1 | \
 242                 sed 's#file://$(my_abs_top_srcdir)/##g' | \
 243                 diff --brief - Test/validate.check.monodocer.since
 244
 245 run-test-local: check-doc-tools
 246
 247 run-test-update : check-doc-tools-update
 248
 249 check-doc-tools: check-monodocer-since \
 250         check-monodocer-importecmadoc \
 251         check-monodocer-importslashdoc \
 252         check-monodocer \
 253         check-monodocer-delete \
 254         check-mdoc-export-html \
 255         check-mdoc-export-html-with-version \
 256         check-mdoc-export-msxdoc \
 257         check-mdoc-validate
 258
 259 check-doc-tools-update: check-monodocer-since-update \
 260         check-monodocer-importecmadoc-update \
 261         check-monodocer-importslashdoc-update \
 262         check-monodocer-update \
 263         check-monodocer-delete-update \
 264         check-mdoc-export-html-update \
 265         check-mdoc-export-msxdoc-update \
 266         check-mdoc-validate-update
 267