IPP Registry Project

About the IPP Registry Project

The ippregistry project provides tools for maintaining the IANA IPP Registry, PWG Semantic Model schema, and sample IPP strings files. It is maintained by the PWG IPP workgroup. Three tools and a script are provided:

apply-pending.sh, a script that applies a list of plain text registrations;
register, a tool to apply plain text registration templates to the current IANA IPP XML registry file;
regtosm, a prototype tool for generating PWG Semantic Model XML schema; and
regtostrings, a tool for generating the ipp.strings file that provides localized strings for all registered attributes and values.

View Prototype IPP Registry View Prototype SM Print3D Schema

Programs

register

./register [-f] [-o NEWFILE.xml] [-t "STANDARD TITLE"] [-x STANDARD-URL] FILENAME.xml [REGTEXT.txt]

Description

register imports plain-text registration templates from specifications or emails into the IANA IPP (XML) registry file. If no template file is specified, register reads from the standard input.

Options

-f: Force writing of new file.
-o NEWFILE.xml: Specifies a new XML file to write to. By default register overwrites the original XML file.
-t "STANDARD TITLE": Specifies the title of the standard or reference to the template.
-x STANDARD-URL: Specifies the URL for the standard or reference. Strings of the form "rfcNNNN" are also supported for RFCs.

regtosm

./regtosm [-a ATTRIBUTE-LIST] [-n NAMESPACE-URL] [-s SERVICE-NAME] [-v VERSION] FILENAME.xml OUTPUT-DIRECTORY

Description

regtosm generates a PWG Semantic Model XML Schema. It is currently used to produce the Prototype SM Print3D Schema.

Options

-a ATTRIBUTE-LIST: Specifies a list of attributes to include in the service description. If not specified, all attributes are included.
-n NAMESPACE-URL: Specifies the namespace URL to use in the generated schema. If not specified, a URL of the form "http://www.pwg.org/schemas/YYYY/MM/sm" is generated.
-s SERVICE-NAME: Specifies the service name to use in the generated schema. If not specified, a service called "Print" is generated.
-v VERSION: Specifies the version number to use in the generated schema. If not specified, a version of the form "2.9nnnnn" is generated, where "nnnnn" is the number of days since 1970.

regtostrings

./regtostrings [ --code ] [ --po ] FILENAME.xml >FILENAME.EXT

Description

regtostrings generates the US English base strings file for all attributes, keywords, and enum values. It is used to generate the IPP strings file at https://ftp.pwg.org/pub/pwg/ipp/examples/ipp.strings.

Options

--code: Specifies that C code should be generated instead of the default Apple .strings format.
--po: Specifies that the GNU gettext message catalog format should be generated instead of the default Apple .strings format.

Legal Stuff

This software is provided under the terms of the Apache License, Version 2.0. A copy of this license can be found in the file LICENSE. Additional legal information is provided in the file NOTICE.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.