gnuastro-commits
[Top][All Lists]
Advanced

[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.
 
 
 



reply via email to

[Prev in Thread] Current Thread [Next in Thread]