Skip to content

Commit

Permalink
Make text format non-normative.
Browse files Browse the repository at this point in the history
  • Loading branch information
HansOlsson committed Mar 4, 2022
1 parent b9482c9 commit a046573
Showing 1 changed file with 4 additions and 2 deletions.
6 changes: 4 additions & 2 deletions chapters/packages.tex
Original file line number Diff line number Diff line change
Expand Up @@ -349,10 +349,11 @@ \section{Multilingual Descriptions}\label{multilingual-descriptions}
\end{enumerate}

The files consist of a header and a body.
The detailed format of these files is described in \href{https://www.gnu.org/software/gettext/manual/gettext.pdf}{GNU gettext}.
\begin{nonnormative}
All text strings are in double quotes and encoded with UTF-8 characters.
Comments start with an \lstinline!#! and are continued until the end of line.
Spaces outside strings are ignored and used as separators.
The detailed format of these files is described in \href{https://www.gnu.org/software/gettext/manual/gettext.pdf}{GNU gettext}.

The header is marked with an empty \emph{msgid} entry and looks like this:
\begin{lstlisting}
Expand Down Expand Up @@ -384,10 +385,11 @@ \section{Multilingual Descriptions}\label{multilingual-descriptions}
msgid "<descriptive text>"
msgstr "<translation>"
\end{lstlisting}
\end{nonnormative}
Only the keywords \lstinline!msgctxt!, \lstinline!msgid! and \lstinline!msgstr! are used.

At first there can be an optional comment describing the location (file name and line number) of the text to translate.
Multiple occurences of the same string can be listed here, separated by space.
Multiple occurences of the same string can be listed here, separated by space.

Then, the \lstinline!<context identifier>! behind the keyword \lstinline!msgctxt! is the full name of the Modelica class (e.g., \lstinline!Modelica.Blocks.Math.Sin!) where the text appears in.
Short class definitions do not appear here.
Expand Down

0 comments on commit a046573

Please sign in to comment.