gnuastro-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[gnuastro-devel] [task #13898] List of documentation authors at start


From: Mohammad Akhlaghi
Subject: [gnuastro-devel] [task #13898] List of documentation authors at start
Date: Sun, 01 May 2016 05:53:05 +0000
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:46.0) Gecko/20100101 Firefox/46.0

Follow-up Comment #3, task #13898 (project gnuastro):

Thanks, the issue is now implemented.

During my work on the bootstrap process (task #13778), I done a similar job.
The AUTHORS file is now automatically generated from the version controlled
history using the "genauthors" script. genauthors is called by both the
bootstrap.conf and any "dist" make rule (for example "make dist" or "make
distcheck" in the top Makefile.am). I used a similar mechanism to implement
this task.

At first I wanted to use "git --log" as you suggested, but then found out that
Git has a better solution (shortlog): 


git shortlog --numbered --summary --email


It is now directly called from within doc/Makefile.am which (after some short
formatting) genrates an "authors.texi" file that is included in gnuastro.texi.


I also thought that since the documentation is not separate from the software
(as discussed in "Science and its tools"), all the contributions to the whole
project should be considered, not just those to the manual.

These issues (including all contributions, including the commit numbers and
emails, sorting and etc..) are all open to discussion, so please feel free to
suggest alternatives or additions. For example we can also include the author
institutions if it is agreed upon.

    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/task/?13898>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/




reply via email to

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