[GRASS-dev] [GRASS GIS] #947: g.version: new flag for citation info

#947: g.version: new flag for citation info
---------------------------------+------------------------------------------
Reporter: hamish | Owner: grass-dev@lists.osgeo.org
     Type: enhancement | Status: new
Priority: normal | Milestone: 7.0.0
Component: default | Version: svn-trunk
Keywords: g.version, citation | Platform: All
      Cpu: All |
---------------------------------+------------------------------------------
Hi,

it is proposed to add a new flag to print out "how to cite grass"
information.

doing this in g.version means that the info would always be up to date and
relevant for the software used.

the obvious choices for flag key -c (cite) -r (ref) -b (biblio) are
already taken, so I propose -x for "cross-ref".

{{{
     cite_flag = G_define_flag();
     cite_flag->key = 'x';
     cite_flag->description =
         _("Display information on how to cite this software");
}}}

the text is currently at:
  http://grass.osgeo.org/download/

{{{
Citing GRASS Software
Please cite GRASS when using the software in your work. Here are some
choices depending on the version used:

     * GRASS Development Team, 2010. Geographic Resources Analysis
       Support System (GRASS) Software, Version 6.4.0. Open Source
       Geospatial Foundation. http://grass.osgeo.org
     * GRASS Development Team, 2009. Geographic Resources Analysis
       Support System (GRASS) Programmer's Manual. Open Source
       Geospatial Foundation. Electronic document:
       http://download.osgeo.org/grass/grass6_progman/

A BibTeX entry for LaTeX users is

@Manual{GRASS_GIS_software,
   title = {Geographic Resources Analysis Support System (GRASS GIS)
Software},
   author = {{GRASS Development Team}},
   organization = {Open Source Geospatial Foundation},
   address = {USA},
   year = {2010},
   url = {http://grass.osgeo.org},
}

}}}

Of course the version and date, etc should be dynamically filled in by the
program.

see also
  http://grass.osgeo.org/wiki/GRASS_Documents#General
  http://grass.osgeo.org/wiki/GRASS_Citation_Repository
  http://grass.osgeo.org/wiki/Citations_for_specific_modules

thanks,
Hamish

--
Ticket URL: <https://trac.osgeo.org/grass/ticket/947&gt;
GRASS GIS <http://grass.osgeo.org>

#947: g.version: new flag for citation info
---------------------------------+------------------------------------------
Reporter: hamish | Owner: grass-dev@…
     Type: enhancement | Status: new
Priority: normal | Milestone: 7.0.0
Component: Default | Version: svn-trunk
Keywords: g.version, citation | Platform: All
      Cpu: All |
---------------------------------+------------------------------------------

Comment(by neteler):

HAmish, do you plan to submit this enhancement?

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/947#comment:1&gt;
GRASS GIS <http://grass.osgeo.org>

#947: g.version: new flag for citation info
---------------------------------+------------------------------------------
Reporter: hamish | Owner: grass-dev@…
     Type: enhancement | Status: new
Priority: normal | Milestone: 7.0.0
Component: Default | Version: svn-trunk
Keywords: g.version, citation | Platform: All
      Cpu: All |
---------------------------------+------------------------------------------

Comment(by hamish):

I would be happy if someone else took up the challenge.

regards,
Hamish

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/947#comment:2&gt;
GRASS GIS <http://grass.osgeo.org>

#947: g.version: new flag for citation info
---------------------------------+------------------------------------------
Reporter: hamish | Owner: grass-dev@…
     Type: enhancement | Status: new
Priority: normal | Milestone: 7.0.1
Component: Default | Version: svn-trunk
Keywords: g.version, citation | Platform: All
      Cpu: All |
---------------------------------+------------------------------------------
Changes (by neteler):

  * milestone: 7.0.0 => 7.0.1

Comment:

For now I have added a citation section here:

http://grass.osgeo.org/grass70/manuals/g.version.html#citing-grass-gis

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/947#comment:3&gt;
GRASS GIS <http://grass.osgeo.org>