[2] | 1 | #+ |
---|
| 2 | # |
---|
[157] | 3 | # .. _makefile_non_sphinx: |
---|
[2] | 4 | # |
---|
[157] | 5 | # =================== |
---|
| 6 | # makefile_non_sphinx |
---|
| 7 | # =================== |
---|
[2] | 8 | # |
---|
[157] | 9 | # génération des manuels à partir des fichiers non assimilables directement |
---|
| 10 | # par sphinx |
---|
[2] | 11 | # |
---|
[58] | 12 | # SEE ALSO |
---|
| 13 | # ======== |
---|
| 14 | # |
---|
[164] | 15 | # :ref:`builddoc` |
---|
[58] | 16 | # |
---|
[157] | 17 | # :ref:`Makefile` |
---|
| 18 | # |
---|
[205] | 19 | # :ref:`<extract_rst.sh fptools:extract_rst.sh>` |
---|
[157] | 20 | # |
---|
[2] | 21 | # TODO |
---|
| 22 | # ==== |
---|
| 23 | # |
---|
[157] | 24 | # check man_troff |
---|
[2] | 25 | # |
---|
[157] | 26 | # improve dependencies |
---|
[2] | 27 | # |
---|
[164] | 28 | # sort manuals in alphanumeric order |
---|
| 29 | # |
---|
[2] | 30 | # EVOLUTIONS |
---|
| 31 | # ========== |
---|
| 32 | # |
---|
[157] | 33 | # $Id$ |
---|
[58] | 34 | # |
---|
[157] | 35 | # $URL$ |
---|
[50] | 36 | # |
---|
[164] | 37 | # - fplod 20120319 |
---|
[168] | 38 | # |
---|
| 39 | # * sort manuals in alphanumeric order |
---|
| 40 | # thanks to |
---|
| 41 | # http://morlockhq.blogspot.fr/2008/09/bash-tip-reverse-sorting-lists-revisted.html |
---|
[164] | 42 | # * fix ferret and odv errors |
---|
| 43 | # |
---|
[157] | 44 | # - fplod 20120306 |
---|
[50] | 45 | # |
---|
[157] | 46 | # * creation from adm/makefile |
---|
[164] | 47 | # * start fix for ../../src/paper01/fig\*/\*.pro |
---|
| 48 | # * start fix for ../../src/test/\*.m |
---|
[42] | 49 | # |
---|
[2] | 50 | #- |
---|
| 51 | # |
---|
| 52 | LIST_SRCSH = \ |
---|
[157] | 53 | $(shell find ../.. ! \( -name '.svn' -prune \) -name "*.sh" ; \ |
---|
| 54 | echo "Makefile"; \ |
---|
| 55 | echo "makefile_non_sphinx" \ |
---|
| 56 | | sort) |
---|
[2] | 57 | |
---|
| 58 | LIST_SRCSH_RST = \ |
---|
| 59 | $(shell echo "$(LIST_SRCSH)" | \ |
---|
[164] | 60 | sed -e "s+../../adm/website+source/manuals+g" \ |
---|
| 61 | -e "s+../../adm+source/manuals+g" \ |
---|
| 62 | -e "s+../../src+source/manuals+g" \ |
---|
| 63 | -e "s+../../docs/docs_dev+source/manuals+g" \ |
---|
[157] | 64 | -e "s+Makefile+source/manuals/Makefile.rst+g" \ |
---|
| 65 | -e "s+makefile_non_sphinx+source/manuals/makefile_non_sphinx.rst+g" \ |
---|
| 66 | -e "s+\.sh+.sh.rst+g") |
---|
[2] | 67 | |
---|
| 68 | LIST_SRCIDL = \ |
---|
[157] | 69 | $(shell find ../.. ! \( -name '.svn' -prune \) -name "*.pro" | sort) |
---|
[2] | 70 | |
---|
| 71 | LIST_SRCIDL_RST = \ |
---|
| 72 | $(shell echo "$(LIST_SRCIDL)" | \ |
---|
[164] | 73 | sed \ |
---|
| 74 | -e "s+../../src/paper01/fig10+source/manuals+g" \ |
---|
| 75 | -e "s+../../src/paper01/fig11+source/manuals+g" \ |
---|
| 76 | -e "s+../../src/paper01/fig12+source/manuals+g" \ |
---|
| 77 | -e "s+../../src/paper01/fig13+source/manuals+g" \ |
---|
| 78 | -e "s+../../src/paper01/fig14+source/manuals+g" \ |
---|
| 79 | -e "s+../../src/paper01/fig15+source/manuals+g" \ |
---|
| 80 | -e "s+../../src/paper01/fig16+source/manuals+g" \ |
---|
| 81 | -e "s+../../src/paper01/fig1+source/manuals+g" \ |
---|
| 82 | -e "s+../../src/paper01/fig2+source/manuals+g" \ |
---|
| 83 | -e "s+../../src/paper01/fig3+source/manuals+g" \ |
---|
| 84 | -e "s+../../src/paper01/fig4+source/manuals+g" \ |
---|
| 85 | -e "s+../../src/paper01/fig5+source/manuals+g" \ |
---|
| 86 | -e "s+../../src/paper01/fig6+source/manuals+g" \ |
---|
| 87 | -e "s+../../src/paper01/fig7+source/manuals+g" \ |
---|
| 88 | -e "s+../../src/paper01/fig8+source/manuals+g" \ |
---|
| 89 | -e "s+../../src/paper01/fig9+source/manuals+g" \ |
---|
| 90 | -e "s+../../src+source/manuals+g" \ |
---|
[2] | 91 | -e "s+\.pro+.pro.rst+g") |
---|
| 92 | |
---|
[30] | 93 | LIST_SRCMATLAB = \ |
---|
[157] | 94 | $(shell find ../.. ! \( -name '.svn' -prune \) -name "*.m" | sort) |
---|
[30] | 95 | |
---|
| 96 | LIST_SRCMATLAB_RST = \ |
---|
| 97 | $(shell echo "$(LIST_SRCMATLAB)" | \ |
---|
[164] | 98 | sed -e "s+../../src/test+source/manuals+g" \ |
---|
| 99 | -e "s+../../src+source/manuals+g" \ |
---|
[157] | 100 | -e "s+\.m+.m.rst+g") |
---|
[30] | 101 | |
---|
| 102 | LIST_SRCFERRET = \ |
---|
[164] | 103 | $(shell find ../.. ! \( -name '.svn' -prune \) -name "*.jnl" | sort) |
---|
[30] | 104 | |
---|
| 105 | LIST_SRCFERRET_RST = \ |
---|
| 106 | $(shell echo "$(LIST_SRCFERRET)" | \ |
---|
[164] | 107 | sed -e "s+../../src/test+source/manuals+g" \ |
---|
[30] | 108 | -e "s+\.jnl+.jnl.rst+g") |
---|
| 109 | |
---|
[31] | 110 | LIST_SRCODV = \ |
---|
[164] | 111 | $(shell find ../.. ! \( -name '.svn' -prune \) -name "*.cmd" | sort) |
---|
[31] | 112 | |
---|
| 113 | LIST_SRCODV_RST = \ |
---|
| 114 | $(shell echo "$(LIST_SRCODV)" | \ |
---|
[164] | 115 | sed -e "s+../../src/test+source/manuals+g" \ |
---|
[31] | 116 | -e "s+\.cmd+.cmd.rst+g") |
---|
| 117 | |
---|
[157] | 118 | LIST_RST = \ |
---|
[168] | 119 | $(shell echo $(LIST_SRCSH_RST) \ |
---|
[157] | 120 | $(LIST_SRCIDL_RST) \ |
---|
| 121 | $(LIST_SRCFERRET_RST) \ |
---|
| 122 | $(LIST_SRCODV_RST) \ |
---|
[168] | 123 | $(LIST_SRCMATLAB_RST) | tr ' ' '\n' | sort | tr '\n' ' ') |
---|
[30] | 124 | |
---|
[2] | 125 | .PHONY : \ |
---|
| 126 | help \ |
---|
| 127 | clean \ |
---|
[157] | 128 | all |
---|
[2] | 129 | |
---|
| 130 | help : |
---|
[164] | 131 | echo "$(LIST_RST)" |
---|
[2] | 132 | @echo "Following commands are available to build outputs :" |
---|
[157] | 133 | @echo "\$$ make -f makefile_non_sphinx clean" |
---|
| 134 | @echo "\$$ make -f makefile_non_sphinx all" |
---|
[2] | 135 | |
---|
[157] | 136 | clean : |
---|
| 137 | -@rm -f $(LIST_RST) 2> /dev/null |
---|
| 138 | -@rm source/manuals/manuals_non_sphinx.rst 2> /dev/null |
---|
[2] | 139 | |
---|
| 140 | |
---|
| 141 | all : \ |
---|
[164] | 142 | source/manuals/manuals_non_sphinx.rst |
---|
[2] | 143 | |
---|
[164] | 144 | source/manuals/manuals_non_sphinx.rst : \ |
---|
| 145 | $(LIST_RST) |
---|
[157] | 146 | @echo ".. _manuals_non_sphinx:" > $@ |
---|
[2] | 147 | @echo " " >> $@ |
---|
[157] | 148 | @echo "non sphinx manuals" | tr [:print:] = >> $@ |
---|
| 149 | @echo "non sphinx manuals" >> $@ |
---|
| 150 | @echo "non sphinx manuals" | tr [:print:] = >> $@ |
---|
[2] | 151 | @echo " " >> $@ |
---|
| 152 | @echo ".. toctree::" >> $@ |
---|
| 153 | @echo " :maxdepth: 1" 1>> $@ |
---|
| 154 | @echo " :glob:" 1>> $@ |
---|
| 155 | @echo " " >> $@ |
---|
[157] | 156 | @for file in $(LIST_RST); \ |
---|
[2] | 157 | do \ |
---|
[157] | 158 | echo " $$(basename $${file} .rst)"; \ |
---|
[2] | 159 | done >> $@ |
---|
| 160 | @echo " " >> $@ |
---|
| 161 | |
---|
[157] | 162 | source/manuals/%.sh.rst : ../../adm/%.sh |
---|
| 163 | @extract_rst.sh -i $< -l sh -o $@ |
---|
[2] | 164 | |
---|
[164] | 165 | source/manuals/%.sh.rst : ../../adm/website/%.sh |
---|
[157] | 166 | @extract_rst.sh -i $< -l sh -o $@ |
---|
[2] | 167 | |
---|
[157] | 168 | source/manuals/%.sh.rst : ../../src/%.sh |
---|
| 169 | @extract_rst.sh -i $< -l sh -o $@ |
---|
[2] | 170 | |
---|
[157] | 171 | source/manuals/%.sh.rst : ../../docs/docs_dev/%.sh |
---|
| 172 | @extract_rst.sh -i $< -l sh -o $@ |
---|
[2] | 173 | |
---|
[157] | 174 | source/manuals/makefile_non_sphinx.rst : ../../docs/docs_dev/makefile_non_sphinx |
---|
| 175 | @extract_rst.sh -i $< -l sh -o $@ |
---|
[2] | 176 | |
---|
[157] | 177 | source/manuals/Makefile.rst : ../../docs/docs_dev/Makefile |
---|
| 178 | @extract_rst.sh -i $< -l sh -o $@ |
---|
[2] | 179 | |
---|
[157] | 180 | source/manuals/%.pro.rst : ../../src/%.pro |
---|
| 181 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
[31] | 182 | |
---|
[164] | 183 | source/manuals/%.pro.rst : ../../src/paper01/fig1/%.pro |
---|
| 184 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 185 | |
---|
| 186 | source/manuals/%.pro.rst : ../../src/paper01/fig2/%.pro |
---|
| 187 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 188 | |
---|
| 189 | source/manuals/%.pro.rst : ../../src/paper01/fig3/%.pro |
---|
| 190 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 191 | |
---|
| 192 | source/manuals/%.pro.rst : ../../src/paper01/fig4/%.pro |
---|
| 193 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 194 | |
---|
| 195 | source/manuals/%.pro.rst : ../../src/paper01/fig5/%.pro |
---|
| 196 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 197 | |
---|
| 198 | source/manuals/%.pro.rst : ../../src/paper01/fig6/%.pro |
---|
| 199 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 200 | |
---|
| 201 | source/manuals/%.pro.rst : ../../src/paper01/fig7/%.pro |
---|
| 202 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 203 | |
---|
| 204 | source/manuals/%.pro.rst : ../../src/paper01/fig8/%.pro |
---|
| 205 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 206 | |
---|
| 207 | source/manuals/%.pro.rst : ../../src/paper01/fig9/%.pro |
---|
| 208 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 209 | |
---|
| 210 | source/manuals/%.pro.rst : ../../src/paper01/fig10/%.pro |
---|
| 211 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 212 | |
---|
| 213 | source/manuals/%.pro.rst : ../../src/paper01/fig11/%.pro |
---|
| 214 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 215 | |
---|
| 216 | source/manuals/%.pro.rst : ../../src/paper01/fig12/%.pro |
---|
| 217 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 218 | |
---|
| 219 | source/manuals/%.pro.rst : ../../src/paper01/fig13/%.pro |
---|
| 220 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 221 | |
---|
| 222 | source/manuals/%.pro.rst : ../../src/paper01/fig14/%.pro |
---|
| 223 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 224 | |
---|
| 225 | source/manuals/%.pro.rst : ../../src/paper01/fig15/%.pro |
---|
| 226 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 227 | |
---|
| 228 | source/manuals/%.pro.rst : ../../src/paper01/fig16/%.pro |
---|
| 229 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 230 | |
---|
[157] | 231 | source/manuals/%.m.rst : ../../src/%.m |
---|
| 232 | @extract_rst.sh -i $< -l matlab -o $@ |
---|
[58] | 233 | |
---|
[164] | 234 | source/manuals/%.m.rst : ../../src/test/%.m |
---|
[157] | 235 | @extract_rst.sh -i $< -l matlab -o $@ |
---|
[2] | 236 | |
---|
[164] | 237 | source/manuals/%.jnl.rst : ../../src/test/%.jnl |
---|
[157] | 238 | @extract_rst.sh -i $< -l ferret -o $@ |
---|
[2] | 239 | |
---|
[164] | 240 | source/manuals/%.cmd.rst : ../../src/test/%.cmd |
---|
[157] | 241 | @extract_rst.sh -i $< -l sh -o $@ |
---|
| 242 | |
---|
| 243 | %.sh.rst : %.sh |
---|
| 244 | @extract_rst.sh -i $< -l sh -o $@ |
---|
| 245 | |
---|
| 246 | %.pro.rst : %.pro |
---|
| 247 | @extract_rst.sh -i $< -l IDL -o $@ |
---|
| 248 | |
---|
| 249 | %.m.rst : %.m |
---|
| 250 | @extract_rst.sh -i $< -l matlab -o $@ |
---|
| 251 | |
---|