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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
|
## Process this file with automake to produce Makefile.inx
##
## This is part of GNU Astronomy Utilities (gnuastro). It will be
## called by the Makefile.am in the top directory.
##
## Original author:
## Mohammad Akhlaghi <mohammad@akhlaghi.org>
## Contributing author(s):
## Copyright (C) 2015-2025 Free Software Foundation, Inc.
##
## GNU Astronomy Utilities is free software: you can redistribute it
## and/or modify it under the terms of the GNU General Public License
## as published by the Free Software Foundation, either version 3 of
## the License, or (at your option) any later version.
##
## GNU Astronomy Utilities is distributed in the hope that it will be
## useful, but WITHOUT ANY WARRANTY; without even the implied warranty
## of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
## GNU General Public License for more details.
##
## You should have received a copy of the GNU General Public License
## along with GNU Astronomy Utilities. If not, see
## <http://www.gnu.org/licenses/>.
## Set the shell
SHELL=/bin/sh
# Built files that should be treated as sources for the main job.
# imgrepresentative: This is just one of the images that is used in the
# book as a representative for all of them because they are all built with
# one script.
imgrepresentative = $(top_srcdir)/doc/gnuastro-figures/done.txt
BUILT_SOURCES = $(srcdir)/authors.texi $(imgrepresentative)
## gpl-3.0.texi (which is just the GPL in Texinfo format) is bootstrapped
## from Gnulib. Therefore it is not in this directory. However, it is
## needed by gnuastro.texi to build the documentation. It is the job of
## AM_MAKEINFOFLAGS, to pass options to the documentation build
## programs. BOOTSTRPDOC is defined in 'configure.ac'.
bootstrpdoc = $(top_srcdir)/bootstrapped/doc
AM_MAKEINFOFLAGS = -I $(bootstrpdoc) -I $(srcdir)
# This is just a temporary work-around since Automake does not pass the
# AM_MAKEINFOFLAGS to texi2dvi (which builds DVI and PDF outputs). This was
# reported in Automake's bug 23599. Note that a space is necessary between
# the '-I' and directory for texi2dvi.
TEXI2DVI = texi2dvi -I $(bootstrpdoc) -I $(srcdir)
## Commands to make the texinfo tools.
info_TEXINFOS = gnuastro.texi
gnuastro_TEXINFOS = fdl.texi formath.texi $(srcdir)/authors.texi \
$(bootstrpdoc)/gpl-3.0.texi
## Files not predefined by Automake, and not in dependencies that must
## be included in the final tar-ball distribution.
EXTRA_DIST = genauthors README
## We want to build 'imgrepresentative' and 'authors.texi' only when we are
## building in the version controlled source (in other words: when
## 'configure' has been re-built). For the non version controlled souce,
## deleting these files is like somehow deleting formath.texi (a core
## file), it will not be rebuilt and result in an error.
$(srcdir)/authors.texi: $(top_srcdir)/configure
$(top_srcdir)/doc/genauthors $(top_srcdir)
## Build the images of the book (with one chosen as representative to act
## as a target in Make).
$(imgrepresentative):
cd $(top_srcdir)/doc/plotsrc; make
## Images and their directories.
infognuastrodir=$(infodir)/gnuastro-figures/
dist_infognuastro_DATA = $(top_srcdir)/doc/gnuastro-figures/*
## Man pages to build
## ==================
##
## Installing all the programs is not mandatory in Gnuastro. If a program
## is not built, we shouldn't build its man-page either.
if COND_ARITHMETIC
MAYBE_ARITHMETIC_MAN = man/astarithmetic.1
endif
if COND_BUILDPROG
MAYBE_BUILDPROG_MAN = man/astbuildprog.1
endif
if COND_CONVERTT
MAYBE_CONVERTT_MAN = man/astconvertt.1
endif
if COND_CONVOLVE
MAYBE_CONVOLVE_MAN = man/astconvolve.1
endif
if COND_COSMICCAL
MAYBE_COSMICCAL_MAN = man/astcosmiccal.1
endif
if COND_CROP
MAYBE_CROP_MAN = man/astcrop.1
endif
if COND_FITS
MAYBE_FITS_MAN = man/astfits.1
endif
if COND_MATCH
MAYBE_MATCH_MAN = man/astmatch.1
endif
if COND_MKCATALOG
MAYBE_MKCATALOG_MAN = man/astmkcatalog.1
endif
if COND_MKPROF
MAYBE_MKPROF_MAN = man/astmkprof.1
endif
if COND_NOISECHISEL
MAYBE_NOISECHISEL_MAN = man/astnoisechisel.1
endif
if COND_QUERY
MAYBE_QUERY_MAN = man/astquery.1
endif
if COND_SEGMENT
MAYBE_SEGMENT_MAN = man/astsegment.1
endif
if COND_STATISTICS
MAYBE_STATISTICS_MAN = man/aststatistics.1
endif
if COND_TABLE
MAYBE_TABLE_MAN = man/asttable.1
endif
if COND_WARP
MAYBE_WARP_MAN = man/astwarp.1
endif
#if COND_TEMPLATE
# MAYBE_TEMPLATE_MAN = man/astTEMPLATE.1
#endif
dist_man_MANS = $(MAYBE_ARITHMETIC_MAN) \
$(MAYBE_BUILDPROG_MAN) \
$(MAYBE_CONVERTT_MAN) \
$(MAYBE_CONVOLVE_MAN) \
$(MAYBE_COSMICCAL_MAN) \
$(MAYBE_CROP_MAN) \
$(MAYBE_FITS_MAN) \
$(MAYBE_MATCH_MAN) \
$(MAYBE_MKCATALOG_MAN) \
$(MAYBE_MKPROF_MAN) \
$(MAYBE_NOISECHISEL_MAN) \
$(MAYBE_QUERY_MAN) \
$(MAYBE_SEGMENT_MAN) \
$(MAYBE_STATISTICS_MAN) \
$(MAYBE_TABLE_MAN) \
$(MAYBE_WARP_MAN) \
man/astscript-color-faint-gray.1 \
man/astscript-ds9-region.1 \
man/astscript-fits-view.1 \
man/astscript-pointing-simulate.1 \
man/astscript-psf-scale-factor.1 \
man/astscript-psf-select-stars.1 \
man/astscript-psf-stamp.1 \
man/astscript-psf-subtract.1 \
man/astscript-psf-unite.1 \
man/astscript-radial-profile.1 \
man/astscript-sort-by-night.1 \
man/astscript-zeropoint.1
## See if help2man is present or not. When help2man doesn't exist, we don't
## want to overwhelm the user with any commands, so we just let them know
## that the distributed man pages will be used.
if COND_HASHELP2MAN
MAYBE_HELP2MAN = help2man --no-discard-stderr --output=$@ \
--source="$(PACKAGE_STRING)"
else
MAYBE_HELP2MAN = @echo "Using man page in tarball (no help2man) for"
endif
# Build the 'man' directory and then put all the man pages in
# it. Unfortunately as far as I know, pattern rules are not portable in all
# implementations of Make, so we have to list all the utilities manually.
toputildir=$(top_builddir)/bin
ALLMANSDEP = $(top_srcdir)/lib/gnuastro-internal/options.h
man/astarithmetic.1: $(top_srcdir)/bin/arithmetic/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "arithmetic operations on images and numbers" \
--libtool $(toputildir)/arithmetic/astarithmetic
man/astbuildprog.1: $(top_srcdir)/bin/buildprog/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "compile, link with Gnuastro library and its dependencies, and run a C program" \
--libtool $(toputildir)/buildprog/astbuildprog
man/astconvertt.1: $(top_srcdir)/bin/convertt/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "convert known data types to each other" \
--libtool $(toputildir)/convertt/astconvertt
man/astconvolve.1: $(top_srcdir)/bin/convolve/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "convolve an image with a given kernel" \
--libtool $(toputildir)/convolve/astconvolve
man/astcosmiccal.1: $(top_srcdir)/bin/cosmiccal/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "estimate cosmological values" \
--libtool $(toputildir)/cosmiccal/astcosmiccal
man/astcrop.1: $(top_srcdir)/bin/crop/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "crop regions of a dataset" \
--libtool $(toputildir)/crop/astcrop
man/astfits.1: $(top_srcdir)/bin/fits/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "view and manipulate FITS headers" \
--libtool $(toputildir)/fits/astfits
man/astmatch.1: $(top_srcdir)/bin/match/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "match catalogs by 1D or 2D positions" \
--libtool $(toputildir)/match/astmatch
man/astmkcatalog.1: $(top_srcdir)/bin/mkcatalog/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "Make a catalog from labeled input images" \
--libtool $(toputildir)/mkcatalog/astmkcatalog
man/astmkprof.1: $(top_srcdir)/bin/mkprof/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "make standard 2D profiles on an image" \
--libtool $(toputildir)/mkprof/astmkprof
man/astnoisechisel.1: $(top_srcdir)/bin/noisechisel/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "detect signal in a noisy image" \
--libtool $(toputildir)/noisechisel/astnoisechisel
man/astquery.1: $(top_srcdir)/bin/query/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "query remote data servers and download" \
--libtool $(toputildir)/query/astquery
man/astsegment.1: $(top_srcdir)/bin/segment/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "segmentation based on signal structure" \
--libtool $(toputildir)/segment/astsegment
man/aststatistics.1: $(top_srcdir)/bin/statistics/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "calculate statistics of a dataset" \
--libtool $(toputildir)/statistics/aststatistics
man/asttable.1: $(top_srcdir)/bin/table/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "read and write ASCII and FITS tables" \
--libtool $(toputildir)/table/asttable
#man/astTEMPLATE.1: $(top_srcdir)/bin/TEMPLATE/args.h $(ALLMANSDEP)
# $(MAYBE_HELP2MAN) -n "put a short description here" \
--libtool $(toputildir)/TEMPLATE/astTEMPLATE
man/astwarp.1: $(top_srcdir)/bin/warp/args.h $(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "warp (transform) input dataset" \
--libtool $(toputildir)/warp/astwarp
# The Scripts:
man/astscript-color-faint-gray.1: $(top_srcdir)/bin/script/color-faint-gray.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "RGB image from FITS images showing bright and faint features" \
--libtool $(toputildir)/script/astscript-color-faint-gray
man/astscript-ds9-region.1: $(top_srcdir)/bin/script/ds9-region.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "Create an SAO DS9 region file from a table" \
--libtool $(toputildir)/script/astscript-ds9-region
man/astscript-fits-view.1: $(top_srcdir)/bin/script/fits-view.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "View FITS images in DS9 and tables in TOPCAT" \
--libtool $(toputildir)/script/astscript-fits-view
man/astscript-pointing-simulate.1: $(top_srcdir)/bin/script/pointing-simulate.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "Simulate the exposure map of a pointing pattern" \
--libtool \
$(toputildir)/script/astscript-pointing-simulate
man/astscript-psf-scale-factor.1: $(top_srcdir)/bin/script/psf-scale-factor.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "Find factor to scale PSF to a given star" \
--libtool \
$(toputildir)/script/astscript-psf-scale-factor
man/astscript-psf-select-stars.1: $(top_srcdir)/bin/script/psf-select-stars.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "Select good stars for constructing the PSF" \
--libtool \
$(toputildir)/script/astscript-psf-select-stars
man/astscript-psf-stamp.1: $(top_srcdir)/bin/script/psf-stamp.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "Make normalized stamp with other sources masked" \
--libtool $(toputildir)/script/astscript-psf-stamp
man/astscript-psf-subtract.1: $(top_srcdir)/bin/script/psf-subtract.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "Subtract a given PSF model from the image" \
--libtool \
$(toputildir)/script/astscript-psf-subtract
man/astscript-psf-unite.1: $(top_srcdir)/bin/script/psf-unite.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "Unite the outer and inner regions of the PSF" \
--libtool $(toputildir)/script/astscript-psf-unite
man/astscript-radial-profile.1: $(top_srcdir)/bin/script/radial-profile.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "Create a radial profile of an object in an image" \
--libtool \
$(toputildir)/script/astscript-radial-profile
man/astscript-sort-by-night.1: $(top_srcdir)/bin/script/sort-by-night.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "Sort input FITS files by night" \
--libtool \
$(toputildir)/script/astscript-sort-by-night
man/astscript-zeropoint.1: $(top_srcdir)/bin/script/zeropoint.sh \
$(ALLMANSDEP)
$(MAYBE_HELP2MAN) -n "Estimate zero point of an image" \
--libtool $(toputildir)/script/astscript-zeropoint
|
