[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gnuastro-commits] master 2631def 10/14: Minor edits in book's configura
From: |
Mohammad Akhlaghi |
Subject: |
[gnuastro-commits] master 2631def 10/14: Minor edits in book's configuration options and intro |
Date: |
Sun, 17 Dec 2017 11:31:19 -0500 (EST) |
branch: master
commit 2631def00191ce10aca2a44b0b585aa430225afa
Author: Mohammad Akhlaghi <address@hidden>
Commit: Mohammad Akhlaghi <address@hidden>
Minor edits in book's configuration options and intro
The last paragraph of the "Gnuastro configure options" section was still
based on the old case where all the programs only worked on images and
MakeProfiles' check was necessary for all the other programs. This not the
case any more, so that statement was corrected.
Also, a small correction was made in the "Science and its tools" section to
be more clear.
---
doc/gnuastro.texi | 55 ++++++++++++++++++++++++++++---------------------------
1 file changed, 28 insertions(+), 27 deletions(-)
diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index 5fd62c8..6fc33a0 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -818,24 +818,24 @@ was changed.
@cindex Anscombe's quartet
@cindex Statistical analysis
-Anscombe's quartet
address@hidden@url{http://en.wikipedia.org/wiki/Anscombe%27s_quartet}}
-demonstrates how four data sets with widely different shapes (when
-plotted) give nearly identical output from standard regression
-techniques. Anscombe argues that ``Good statistical analysis is not a
-purely routine matter, and generally calls for more than one pass
-through the computer''. Anscombe's quartet can be generalized to say
-that users of a software cannot claim to understand how it works only
-based on the experience they have gained by frequently using it. This
-kind of subjective experience is prone to very serious
-mis-understandings about what it really does behind the scenes and can
-be misleading. This attitude is further encouraged through non-free
address@hidden@url{https://www.gnu.org/philosophy/free-sw.html}}.
-This approach to scientific software only helps in producing dogmas
-and an ``obscurantist faith in the expert's special skill, and in his
-personal knowledge and authority''@footnote{Karl Popper. The logic of
-scientific discovery. 1959. Larger quote is given at the start of the
-PDF (for print) version of this book.}.
address@hidden://en.wikipedia.org/wiki/Anscombe%27s_quartet,Anscombe's quartet}
+demonstrates how four data sets with widely different shapes (when plotted)
+give nearly identical output from standard regression techniques. Anscombe
+uses this (now famous) quartet, which was introduced in the paper quoted
+above, to argue that ``Good statistical analysis is not a purely routine
+matter, and generally calls for more than one pass through the
+computer''. Anscombe's quartet can be generalized to say that users of a
+software cannot claim to understand how it works only based on the
+experience they have gained by frequently using it. This kind of subjective
+experience is prone to very serious mis-understandings about what it really
+does behind the scenes and can be misleading. This attitude is further
+encouraged through non-free
address@hidden@url{https://www.gnu.org/philosophy/free-sw.html}}. This
+approach to scientific software only helps in producing dogmas and an
+``obscurantist faith in the expert's special skill, and in his personal
+knowledge and authority''@footnote{Karl Popper. The logic of scientific
+discovery. 1959. Larger quote is given at the start of the PDF (for print)
+version of this book.}.
@quotation
@cindex Douglas Rushkoff
@@ -4560,15 +4560,16 @@ is equivalent to simply enabling those that were
enabled. Listing the
disabled programs is redundant.
@end cartouche
-Note that the tests of some programs might require other programs to
-have been installed and tested. For example MakeProfiles is the first
-program to be tested when you run @command{$ make check}, it provides
-the inputs to all the other tests. So if you don't install
-MakeProfiles, then the tests for all the other programs will be
-skipped or fail. To avoid this, in one run, you can install all the
-packages and run the tests but not install. If everything is working
-correctly, you can run configure again with only the packages you want
-but not run the tests and directly install after building.
+The tests of some programs might depend on the outputs of the tests of
+other programs. For example MakeProfiles is one the first programs to be
+tested when you run @command{$ make check}. MakeProfiles' test outputs
+(FITS images) are inputs to many other programs (which in turn provide
+inputs for other programs). Therefore, if you don't install MakeProfiles
+for example, the tests for many the other programs will be skipped. To
+avoid this, in one run, you can install all the programs and run the tests
+but not install. If everything is working correctly, you can run configure
+again with only the programs you want. However, don't run the tests and
+directly install after building.
- [gnuastro-commits] master updated (589ca52 -> 0487ba5), Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master c46e36d 03/14: Minor corrections in webpage script, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master 0bbdf6d 05/14: Minor corrections to optional dependencies, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master 74dd74f 08/14: Match program's man page is built, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master c6a96b2 07/14: In citation, primarily was changed to initially, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master 0487ba5 14/14: Initializing delta and dist arrays in match library, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master 2631def 10/14: Minor edits in book's configuration options and intro,
Mohammad Akhlaghi <=
- [gnuastro-commits] master d7a7c37 12/14: Minor edits in book, acknowledgements updated, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master c448b38 04/14: Better explanation on GNU Libtool in book, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master f0a4d1e 01/14: In configure, current directory removed from PATH, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master 104b657 06/14: Configuration warning if PATH includes current directory, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master 481b53a 13/14: -Qunused-arguments now dealt with in CXXFLAGS, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master 182f397 11/14: No -pthread flag in LDFLAGS, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master e9842b5 02/14: Webpage translations now fully incorporated, Mohammad Akhlaghi, 2017/12/17
- [gnuastro-commits] master eef4e80 09/14: Arithmetic's binary operators don't need compiled types, Mohammad Akhlaghi, 2017/12/17