[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gnuastro-commits] master 745eadf 2/2: NEWS, README, THANKS, and top web
|
From: |
Mohammad Akhlaghi |
|
Subject: |
[gnuastro-commits] master 745eadf 2/2: NEWS, README, THANKS, and top webpage updated |
|
Date: |
Mon, 3 Oct 2016 00:35:36 +0000 (UTC) |
branch: master
commit 745eadf4ec164a1d9569e29f92a3a674ea7cb8fa
Author: Mohammad Akhlaghi <address@hidden>
Commit: Mohammad Akhlaghi <address@hidden>
NEWS, README, THANKS, and top webpage updated
The `NEWS', `README', `THANKS' and the top webpage
(`doc/gnuastro-top.html') files have been updated for the 0.2
release. Besides these, the `doc/release-checklist.txt' was also updated.
---
NEWS | 27 ++++++++++++++++++------
README | 31 ++++++++++++++--------------
THANKS | 2 ++
doc/gnuastro-top.html | 34 ++++++++++++------------------
doc/release-checklist.txt | 50 ++++++++++++++++++++++++++++++++++++---------
5 files changed, 92 insertions(+), 52 deletions(-)
diff --git a/NEWS b/NEWS
index 0c50200..baa1333 100644
--- a/NEWS
+++ b/NEWS
@@ -1,6 +1,6 @@
GNU Astronomy Utilities NEWS -*- outline -*-
-* Noteworthy changes in release 0.1.152 (library 0.0.0) (2016-09-24) [alpha]
+* Noteworthy changes in release 0.2 (library 0.0.0) (2016-10-03) [stable]
** Bug fixes
@@ -16,7 +16,8 @@ GNU Astronomy Utilities NEWS -*-
outline -*-
** New programs or headers
Table: a new utility to read and write FITS binary and ASCII tables. It
- can also print the column information (task #13579).
+ can also print the column information or select columns using regular
+ expressions (task #13579).
Shared libraries and headers are now installed. The libraries can be used
in C and C++ programs. This release includes the following headers:
@@ -25,10 +26,9 @@ GNU Astronomy Utilities NEWS -*-
outline -*-
`wcs.h', `txtarray.h' (task #13765).
Gnuastro now comes with a script in its top source directory
- (`tmpfs-config-make') to configure and build Gnuastro (or any other
- program using the GNU build system) in the tmpfs (on the RAM) for those
- systems that have it. See the new "Configure and build in RAM" section in
- the book for more (task #14100).
+ (`tmpfs-config-make') to configure and build it in the tmpfs (on the
+ RAM), for those systems that have it. See the new "Configure and build in
+ RAM" section in the book for more (task #14100).
** New features
@@ -59,6 +59,13 @@ GNU Astronomy Utilities NEWS -*-
outline -*-
sharper profiles by disabling erosion on pixels above a certain quantile
(task #14139).
+ MakeCatalog can also calculate the upper limit magnitude for each given
+ object in the image by randomly positioning the object's footprint over
+ undetected regions of the image (task #14167).
+
+ The source tarball is now also distributed with Lzip for a much better
+ compression ratio and more robust archival file format.
+
** Changes in behavior
The two MakeProfiles options `--setconsttonan', `--setconsttomin' have
@@ -69,6 +76,14 @@ GNU Astronomy Utilities NEWS -*-
outline -*-
aperture photometry, when the object labels are not generated by
NoiseChisel and so a clump image doesn't exist (task #14122).
+ Default cosmological parameters in CosmiCalculator set to Plank 2015
+ results: A&A (2016), 594, A13 (arXiv 1502.01589).
+
+ The `--envseed' option (to read random number generator type and seed
+ from the environment) to MakeProfiles and MakeNoise can also be given in
+ the configuration files.
+
+
* Noteworthy changes in release 0.1 (2016-05-30) [stable]
** Bug fixes
diff --git a/README b/README
index cbe418d..a78bb01 100644
--- a/README
+++ b/README
@@ -3,11 +3,11 @@ GNU Astronomy Utilities
GNU Astronomy Utilities (Gnuastro) is an official GNU package of programs
and a library functions for astronomical data manipulation and
-analysis. The programs run directory on the operating system's command-line
-enabling easy operation and usage with other installed programs in shell
-scripts or Makefiles. The libraries are also usable in C and C++
-programs. The full package comes with a comprehensive book or documentation
-in various formats (plain text, info, PDF and HTML):
+analysis. The programs are run directory on the operating system's
+command-line enabling easy and efficient operation combined with other
+installed programs in shell scripts or Makefiles. The libraries are also
+usable in C and C++ programs. The full package comes with a comprehensive
+book or documentation in various formats (plain text, info, PDF and HTML):
http://www.gnu.org/software/gnuastro/manual/
@@ -22,11 +22,12 @@ your Unix-like operating system (see Chapter 2).
If you have already installed gnuastro, you can read the full book by
running the following command. You can go through the whole book by
pressing the 'SPACE' key, and leave the Info environment at any time by
-pressing 'q' key, see "Getting help" below for more.
+pressing 'q' key. See the "Getting help" section below (in this file) or in
+the book for more.
info gnuastro
-The utilities released in version 0.2 are listed below followed by their
+The programs released in version 0.2 are listed below followed by their
executable name in parenthesis and a short description. This list is
ordered alphabetically. In the book, they are grouped and ordered by
context under categories/chapters.
@@ -86,8 +87,8 @@ context under categories/chapters.
file. Output columns can also be determined by number or regular
expression matching of column names.
-All the various programs share the same basic command-line user interface
-and a set of common options for the comfort of both the users and
+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
standards so it integrates finely with the GNU/Linux operating system and
Unix-like operating systems in general. This also enables astronomers to
@@ -96,14 +97,14 @@ and command line user interaction that they have seen in
all the other GNU
software that they use.
Behind the scenes, Gnuastro comes with a very robust infra-structure
-enabling easy addition of new utilities and new features to existing
-utilities and a full chapter devoted to explaining how to develop most
+enabling easy addition of new programs and new features to existing
+programs and a full chapter devoted to explaining how to develop most
effectively (see the "Developing" chapter). Please join us in developing
this comprehensive and low level set of tools for astronomical data
manipulation and analysis. The copyright owner of Gnuastro is the Free
Software Foundation to guarantee its freedom in the future, and not any
particular astronomer or astronomical project, or astronomical institution,
-so please join us.
+so please join us and feel free to use it in your research.
@@ -133,7 +134,7 @@ the standard GNU Build system as shown below. After the
'./configure'
command, Gnuastro will print messages upon the successful completion of
each step, giving further information and suggestions for the next steps.
- tar xf gnuastro-latest.tar.gz
+ tar xf gnuastro-latest.tar.gz # Also works for `tar.lz' files
cd gnuastro-0.1
./configure
make
@@ -169,14 +170,14 @@ is short and only takes about an hour, so we strongly
recommend it):
info info
-To immediately get a short list of each utility's options and a short
+To immediately get a short list of each programs's options and a short
explanation of each, please run:
astprogname --help # For example 'astnoisechisel --help'
Ultimately you can send a mail to 'address@hidden' to get help in
installing or using Gnuastro. Some Gnuastro developers and active users are
-subscribed to this list and are ready to help you in using these utilities.
+subscribed to this list and are ready to help you in using these programs.
diff --git a/THANKS b/THANKS
index 05fe141..8ff8879 100644
--- a/THANKS
+++ b/THANKS
@@ -16,6 +16,8 @@ authors of Gnuastro. We hereby gratefully acknowledge their
help and
support in Gnuastro. The list is ordered alphabetically.
Karl Berry address@hidden
+ Roland Bacon address@hidden
+ Antonio Diaz Diaz address@hidden
Takashi Ichikawa address@hidden
Brandon Invergo address@hidden
Mohammad-Reza Khellat address@hidden
diff --git a/doc/gnuastro-top.html b/doc/gnuastro-top.html
index ee89987..1912281 100644
--- a/doc/gnuastro-top.html
+++ b/doc/gnuastro-top.html
@@ -126,25 +126,23 @@ for entertaining and easy to read real world examples of
using
<h3 id="download">Download</h3>
<p>The current stable release
- is <a href="http://ftp.gnu.org/gnu/gnuastro/gnuastro-0.1.tar.gz";>Gnuastro
- 0.1</a> (30 May 2016).
- Use <a href="http://ftpmirror.gnu.org/gnuastro/gnuastro-0.1.tar.gz";>a
+ is <a href="http://ftp.gnu.org/gnu/gnuastro/gnuastro-0.2.tar.gz";>Gnuastro
+ 0.2</a> (October 3rd, 2016).
+ Use <a href="http://ftpmirror.gnu.org/gnuastro/gnuastro-0.2.tar.gz";>a
mirror</a> if possible.<br />New releases are announced
- in <a
href="https://lists.gnu.org/mailman/listinfo/info-gnuastro";>info-gnuastro</a>,
- to stay up to date please subscribe.
- <br /><span style="background-color: #66cc00"><b>Bug fixed:</b></span>
- Please use
- <a href="http://alpha.gnu.org/gnu/gnuastro/gnuastro-alpha-latest.tar.gz";>this
- alpha-release</a> if the <code>make</code> command from Gnuastro 0.1
- fails with an '<code>error: ld</code>'
- (<a href="https://savannah.gnu.org/bugs/index.php?48076";
- target="_blank">bug #48076</a>, this is a bug only in some operating
- systems, you might not need it).</p>
+ in <a
href="https://lists.gnu.org/mailman/listinfo/info-gnuastro";>info-gnuastro</a>.
+ To stay up to date, please subscribe.</p>
<p>For details of the significant changes in this release, please see
- the <a
href="http://git.savannah.gnu.org/cgit/gnuastro.git/plain/NEWS?id=gnuastro_v0.1";>NEWS</a>
+ the <a
href="http://git.savannah.gnu.org/cgit/gnuastro.git/plain/NEWS?id=gnuastro_v0.2";>NEWS</a>
file.</p>
+<p>The
+ canonical <a
href="http://ftp.gnu.org/gnu/gnuastro/gnuastro-latest.tar.gz";></a<>http://ftp.gnu.org/gnu/gnuastro/gnuastro-latest.tar.gz</a>
+ will always contain the most recent Gnuastro release. Use the mirror link
+ (<a
href="http://ftpmirror.gnu.org/gnuastro/gnuastro-latest.tar.gz";>http://ftpmirror.gnu.org/gnuastro/gnuastro-latest.tar.gz</a>)
+ if possible.</p>
+
<p>The <a href="manual/html_node/Installation.html">Installation</a>
chapter of the <a href="manual/">Gnuastro book</a>
thoroughly discusses
@@ -161,16 +159,10 @@ for entertaining and easy to read real world examples of
using
check</code>, and <code>make install</code> are enough
(see <a href="manual/html_node/Quick-start.html">Quick start</a>).</p>
-<p>Previous versions and PGP signatures are available
+<p>Previous versions and PGP signatures are always available
at <a
href="http://ftp.gnu.org/gnu/gnuastro";>http://ftp.gnu.org/gnu/gnuastro</a>. Use
<a href="http://ftpmirror.gnu.org/gnuastro";>a
mirror</a> if possible. </p>
-<p>The
- canonical <a
href="http://ftp.gnu.org/gnu/gnuastro/gnuastro-latest.tar.gz";></a<>http://ftp.gnu.org/gnu/gnuastro/gnuastro-latest.tar.gz</a>
- is also available for the latest
- release. Use <a
href="http://ftpmirror.gnu.org/gnuastro/gnuastro-latest.tar.gz";>http://ftpmirror.gnu.org/gnuastro/gnuastro-latest.tar.gz</a>
- if possible.</p>
-
diff --git a/doc/release-checklist.txt b/doc/release-checklist.txt
index 9ceff85..8dd987f 100644
--- a/doc/release-checklist.txt
+++ b/doc/release-checklist.txt
@@ -5,33 +5,59 @@ This file is primarily intended for the Gnuastro maintainer
and lists the
set of operations to do for making each release. This should be done after
all the commits needed for this release have been completed.
+
- Only in a stable release: update the library version (the values
starting with `GAL_' in `configure.ac'). See the `Updating library
version information' section of the GNU Libtool manual as a guide.
+
- Update the NEWS file (use `git log --reverse gnuastro_vA.B..HEAD').
- Also update the library version for this release in the NEWS file.
+
- Check if README includes all the recent updates and important features.
+
- Check if THANKS is up to date and includes recently updated
people/institutions.
- - Commit all the changes above
- - Only in a stable release: Tag the commit for the release.
+ - Update the webpage (`doc/gnuastro-top.html') and correct the links.
+
+
+ - Commit all these changes and tag the commit:
+
+ $ git add -u
+ $ git commit
+
- Make sure all the bootstrapping tools are up to date (keep the
versions in text file to use in the release), then bootstrap and
rebuild everything:
- $ git clean -fxd
- $ ./bootstrap --copy --gnulib-srcdir=/path/to/gnulib
- $ ./tmpfs-config-make
- $ cd build
- $ make distcheck -j8
- $ make dist-lzip
+ $ git clean -fxd
+ $ ./bootstrap --copy --gnulib-srcdir=/path/to/gnulib
+ $ ./tmpfs-config-make
+ $ cd build
+ $ make distcheck -j8
+
+
+ - After the `make distcheck' is safely finished, tag the release:
+
+ $ git tag -a gnuastro_vX.X
+
+
+ - The tag will cause a change in the tarball version. So clean the build
+ directory, and repeat the steps for the final release:
+
+ $ rm -rf ./build/*
+ $ autoreconf -f
+ $ ./tmpfs-config-make
+ $ cd build
+ $ make distcheck -j8
+ $ make dist-lzip
+
- Upload the tarball with the command below: Note that `gnupload'
uses `ncftpput' which comes with the `ncftp' package. The replaces
@@ -49,13 +75,17 @@ all the commits needed for this release have been completed.
--replace --symlink-regex \
gnuastro-X.X.tar.gz gnuastro-X.X.tar.lz
- - Update the the top webpage (`doc/gnuastro-top.html' and possible
- translations).
- Build the manual in all the formats and upload everything:
$ cd doc # From the top source directory:
$ ./forwebpage /path/to/local/copy/of/webpage
+
+ - Push all the changes and tag to the main repo:
+
+ $ git push --follow-tags
+
+
- Announce the release on address@hidden', address@hidden' and
Savannah news.