[gnuastro-commits] master 2f82efe: Citation discussed in top webpage, ASCL code included

[Mohammad Akhlaghi]

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

    Citation discussed in top webpage, ASCL code included
    
    The top webpage lacked a section to discuss the recommended way of citing
    Gnuastro. So a small section was added to the top English page (a
    translation request to the GNU French Translators team will be sent after
    this commit).
    
    Gnuastro was recently registered on the Astrophysical Source Code Library
    (ASCL). Therefore, the ASCL registration id is now also included in the
    output of `--cite' (as well as the new section on the top webpage).
---
 doc/gnuastro.en.html | 32 ++++++++++++++++++++++++++++++++
 lib/options.c        | 11 ++++++-----
 2 files changed, 38 insertions(+), 5 deletions(-)

diff --git a/doc/gnuastro.en.html b/doc/gnuastro.en.html
index aaa7930..fd69b8a 100644
--- a/doc/gnuastro.en.html
+++ b/doc/gnuastro.en.html
@@ -325,6 +325,38 @@ Please use the mailing lists for contact. </dd>
 
 
 
+<h3 id="cite">Citation</h3>
+
+<p>Citations are vital for the continued work on Gnuastro. All the programs
+  accept the <code>--cite</code> option which will guide you on how to
+  properly cite and acknowledge the work that has gone into creating and
+  maintaining that particular program and Gnuastro in general. If any of
+  the programs or libraries offered in Gnuastro are useful in your
+  research, please use the output of this option to cite the program and
+  Gnuastro in your research paper. Note that different programs may require
+  citation of different papers specifically devoted to them.</p>
+
+<p>Gnuastro is still new, thus there is no paper fully devoted to
+  introducing it and its capabilities yet. Until then, the paper to cite
+  for Gnuastro in general is the paper which introduced NoiseChisel
+  (<a href="http://adsabs.harvard.edu/abs/2015ApJS..220....1A";>ApJS 220,
+  1</a>). It was the first published paper using Gnuastro. Upon reaching a
+  certain point, a paper completely devoted to Gnuastro will be published,
+  see <a 
href="https://www.gnu.org/software/gnuastro/manual/html_node/GNU-Astronomy-Utilities-1_002e0.html";>GNU
+  Astronomy Utilities 1.0</a>.</p>
+
+<p>Gnuastro is also registered on the Astrophysics Source Code Library
+  (<a href="http://ascl.net";>ASCL</a>)
+  with <a href="http://ascl.net/1801.009";>ascl.net/1801.009</a>. Please use
+  this identifier somewhere in the body of your paper (for example in the
+  acknowledgments or first mention of Gnuastro). For the
+  bibliography/references list at the end of the paper, please only use the
+  papers listed in the output of <code>--cite</code>.</p>
+
+
+
+
+
 <h3 id="license">Licensing</h3>
 
 <p>GNU Astronomy Utilities (Gnuastro) is free software; you can
diff --git a/lib/options.c b/lib/options.c
index 75c9423..46e2743 100644
--- a/lib/options.c
+++ b/lib/options.c
@@ -270,11 +270,12 @@ gal_options_print_citation(struct argp_option *option, 
char *arg,
                "Acknowledgement\n"
                "---------------\n"
                "This work was partly done using GNU Astronomy Utilities "
-               "(Gnuastro) version %s. Gnuastro is a generic package for "
-               "astronomical data manipulation and analysis which was "
-               "initially created and developed for research funded by the "
-               "Monbukagakusho (Japanese government) scholarship and ERC "
-               "advanced grant 339659-MUSICOS.", PACKAGE_VERSION)<0 )
+               "(Gnuastro, ascl.net/1801.009) version %s. Gnuastro is a "
+               "generic package for astronomical data manipulation and "
+               "analysis which was initially created and developed for "
+               "research funded by the Monbukagakusho (Japanese "
+               "government) scholarship and European Research Council "
+               "(ERC) advanced grant 339659-MUSICOS.", PACKAGE_VERSION)<0 )
     error(EXIT_FAILURE, 0, "%s: asprintf allocation", __func__);
   printf("%s\n", gnuastro_acknowledgement);
   free(gnuastro_acknowledgement);