Update documentation and examples

biblatex/history.tex

+\begin{release}{bltx-v1.0}{2020-04-25} \item First public release \end{release}
 \begin{release}{bltx-v0.9}{2020-04-25} \item Preparing for public release: Licence, Readme, update documentation, handle suggestions from the Working Group \end{release}
 \begin{release}{bltx-v0.8}{2020-04-09} \item Make the style usable as an extension, and keep possibility of generating extended styles \end{release}
 \begin{release}{bltx-v0.7}{2020-04-09} \item Move to diff model approach to be more portable \end{release}

biblatex/swentries.tex

@@ -8,7 +8,7 @@ Computer software.
 
 \emph{Required fields:} \texttt{author} / \texttt{editor}, \texttt{title}, \texttt{url}, \texttt{year}
 
-\emph{Optional fields:} \texttt{abstract}, \texttt{date}, \texttt{doi}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
+\emph{Optional fields:} \texttt{abstract}, \texttt{date}, \texttt{doi}, \texttt{eid}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
 \texttt{institution}, \texttt{license}, \texttt{month}, \texttt{note}, \texttt{organization}, \texttt{publisher},
 \texttt{related}, \texttt{relatedtype}, \texttt{relatedstring}, \texttt{repository}, \texttt{swhid}, \texttt{urldate}, \texttt{version}
 
@@ -18,7 +18,7 @@ fields from the entry mentioned in the \texttt{crossref} field.
 
 \emph{Required fields:} \texttt{author} / \texttt{editor}, \texttt{title}, \texttt{url}, \texttt{version}, \texttt{year}
 
-\emph{Optional fields:} \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
+\emph{Optional fields:} \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{eid}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
 \texttt{institution}, \texttt{introducedin}, \texttt{license}, \texttt{month}, \texttt{note}, \texttt{organization}, \texttt{publisher},
 \texttt{related}, \texttt{relatedtype}, \texttt{relatedstring}, \texttt{repository}, \texttt{swhid}, \texttt{subtitle}, \texttt{urldate}
 
@@ -29,7 +29,7 @@ fields from the entry mentioned in the \texttt{crossref} field.
 
 \emph{Required fields:} \texttt{author}, \texttt{subtitle}, \texttt{url}, \texttt{year}
 
-\emph{Optional fields:} \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{editor}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
+\emph{Optional fields:} \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{eid}, \texttt{editor}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
 \texttt{institution}, \texttt{introducedin}, \texttt{license}, \texttt{month}, \texttt{note}, \texttt{organization}, \texttt{publisher},
 \texttt{related}, \texttt{relatedtype}, \texttt{relatedstring}, \texttt{repository}, \texttt{swhid}, \texttt{title}, \texttt{urldate}, \texttt{version}
 
@@ -40,7 +40,7 @@ Inherits values of missing fields from the entry mentioned in the \texttt{crossr
 
 \emph{Required fields:}  \texttt{url}
 
-\emph{Optional fields:} \texttt{author}, \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
+\emph{Optional fields:} \texttt{author}, \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{eid}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
 \texttt{institution}, \texttt{introducedin}, \texttt{license}, \texttt{month}, \texttt{note}, \texttt{organization}, \texttt{publisher},
 \texttt{related}, \texttt{relatedtype}, \texttt{relatedstring}, \texttt{repository}, \texttt{swhid}, \texttt{subtitle}, \texttt{title}, \texttt{urldate}, \texttt{version}, \texttt{year}
 
@@ -63,6 +63,7 @@ style. It is not used by all standard bibliography styles.
 \item[{editor}] list (name). The coordinator(s) of large modular software projects.
 \item[{file}] field (verbatim). A link to download a copy of the work.
 \item[{doi}] field (verbatim). The Digital Object Identifier of the work.
+\item[{eid}] field (verbatim). An electronic identifier of the work.
 \item[{\texttt{hal\_id} [not in biblatex standard styles]}] field (verbatim). A digital identifier for the 
 software record including its description and metadata on HAL.
 \item[{\texttt{hal\_version} [not in biblatex standard styles]}] field (verbatim). The version of the HAL software record designated by \texttt{hal\_id}.
@@ -74,14 +75,11 @@ For compatibility with BibTeX, one can also use the three letter
 abbreviations \emph{jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec},
 which must be given without any braces or quotes.
 \item[{note}] field (literal). Release note of the cited version.
-\item[{institution}] field (literal). The institution(s) that took part in the 
-software project.
+\item[{institution}] list (literal). The institution(s) that took part in the software project.
 \item[{introducedin [not in biblatex standard styles]}] field (literal). If this is a software module or fragment,
 the version of the containing project where it has been first introduced.
-\item[{organization}] field (literal). The organization(s) that took part in the 
-software project.
-\item[{publisher}] list (literal). The name(s) of the publisher(s) of the software
-record (we need to define the notion of a research software publisher, see issue \href{https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/issues/2}{\#2}).
+\item[{organization}] list (literal). The organization(s) that took part in the software project.
+\item[{publisher}] list (literal). The name(s) of the publisher(s) of the \emph{qualified} software record.
 \item[{related [biblatex only]}] field (separated values). Citation keys of other entries which have a relationship to this entry.
 \item[{relatedtype [biblatex only]}] field (identifier).
 \item[{relatedstring [biblatex only]}] field (literal).
@@ -233,7 +231,7 @@ we can do this as follows:
   author = {Di Cosmo, Roberto and Marco Danelutto},
   year = {2020},
   version = {1.1.1},
-  institution = {Inria},
+  institution = {{Inria} and {University of Paris} and {University of Pisa}},
   license = {LGPL-2.0},
   url = {https://rdicosmo.github.io/parmap/},
   repository= {https://github.com/rdicosmo/parmap},