[gnuastro-commits] master a1e9c0f: astscript-sort-by-night: introduced in README and program list

[Mohammad Akhlaghi]

branch: master
commit a1e9c0f6f123cff908e9d945ce98367e7f798626
Author: Mohammad Akhlaghi <address@hidden>
Commit: Mohammad Akhlaghi <address@hidden>

    astscript-sort-by-night: introduced in README and program list
    
    Since the scripts are also installed and operationally, they are like
    programs, it was necessary to treat them like programs in the `README' file
    and also the "Gnuastro program list" of the book's Appendix A. An
    explanation has been added to clarify their difference from the rest of the
    programs.
---
 README            | 10 ++++++++++
 doc/gnuastro.texi | 13 ++++++++++++-
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/README b/README
index 078aa5d..098d4eb 100644
--- a/README
+++ b/README
@@ -99,6 +99,16 @@ categories/chapters.
   - Warp (astwarp): Warp image to new pixel grid. Any projective
     transformation or Homography can be applied to the input images.
 
+The programs listed above are designed to be highly modular and
+generic. For higher-level operations (combining multiple programs, or
+running a program in a special way), Gnuastro also installs Bash scripts
+(all prefixed with `astscript-'). They can be run like a program and behave
+very similarly (with minor differences, as explained in the book).
+
+  - astscript-sort-by-night: Given a list of FITS files, and a HDU and
+    keyword name for a date, this script separates the files in the same
+    night (possibly over two calendar days).
+
 All the programs share the same basic command-line user interface and a set
 of common options for the comfort of both the users and
 developers. Gnuastro is written to comply fully with the GNU coding
diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index dcc8f2c..c05151b 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -31996,7 +31996,6 @@ parenthesis. Throughout this book, they are ordered 
based on their context,
 please see the top-level contents for contextual ordering (based on what
 they do).
 
-
 @table @asis
 
 @item Arithmetic
@@ -32083,7 +32082,19 @@ projective transformation or Homography can be applied 
to the input images.
 
 @end table
 
+The programs listed above are designed to be highly modular and
+generic. Hence, they are naturally for lower-level operations. In Gnuastro,
+higher-level operations (combining multiple programs, or running a program
+in a special way), are done with installed Bash scripts (all prefixed with
address@hidden). They can be run just like a program and behave very
+similarly (with minor differences, see @ref{Installed scripts}).
 
address@hidden @code
address@hidden astscript-sort-by-night
+(See @ref{Sort FITS files by night}) Given a list of FITS files, and a HDU
+and keyword name (for a date), this script separates the files in the same
+night (possibly over two calendar days).
address@hidden table