external/cde
1
0
Fork 0
mirror of git://git.code.sf.net/p/cdesktopenv/code synced 2025-03-09 15:50:02 +00:00
Code Issues Releases Wiki Activity

doc: update dtdocbook2infolib related documents.

Browse source
This commit is contained in:
Liang Chang 2022-03-03 13:27:52 +00:00
parent 9904fe4c94
commit 3795cdbd5e
19 changed files with 282 additions and 282 deletions
Download patch file Download diff file Expand all files Collapse all files

8
cde/doc/en_US.UTF-8/guides/infoAPg/ch01.sgm
View file

@ -174,7 +174,7 @@ See
<ListItem>
<Para>
Build browser-readable information libraries using the
<Command>dtinfogen build</Command> command.
<Command>dtdocbook2infolib build</Command> command.
</Para>
<Para>
See
@ -190,7 +190,7 @@ On Information Manager libraries that are already built, you can:
<Para>
Replace existing style sheets or style sheet information
in the document database, without rebuilding the
database, using the <Command>dtinfogen update</Command> command.
database, using the <Command>dtdocbook2infolib update</Command> command.
</Para>
<Para>
See
@ -200,7 +200,7 @@ See
<ListItem>
<Para>
Add or replace a bookcase in the library using the
<Command>dtinfogen build</Command> command.
<Command>dtdocbook2infolib build</Command> command.
</Para>
<Para>
See
@ -211,7 +211,7 @@ See
<ListItem>
<Para>
Copy, remove, rename, list, or rearrange bookcases in a
library using the <Command>dtinfogen admin</Command> command.
library using the <Command>dtdocbook2infolib admin</Command> command.
</Para>
<Para>See
<Link Linkend="B7XKbKBcgmg24aK">Administering Bookcases</Link>.

30
cde/doc/en_US.UTF-8/guides/infoAPg/ch03.sgm
View file

@ -39,7 +39,7 @@ and its SGML markup.
</link> &mdash; Each Information Manager book requires a hypertext TOC that
conforms to <filename>dtinfoTOC.dtd(5)</filename>.
You can create the hypertext TOC with the
<command>dtinfogen tocgen</command> command.
<command>dtdocbook2infolib tocgen</command> command.
</para>
</listitem>
<listitem>
@ -141,8 +141,8 @@ in <citetitle pubwork="Book">International Standards Organization (ISO) 8879
The Information Manager's SGML declaration
<filename>dtinfo.decl</filename> is supplied with the Information
Manager and is referenced automatically when you invoke the
<command>dtinfogen build</command>, <command>dtinfogen
validate</command>, or <command>dtinfogen update</command> commands.
<command>dtdocbook2infolib build</command>, <command>dtdocbook2infolib
validate</command>, or <command>dtdocbook2infolib update</command> commands.
</para>
</note>
<figure>
@ -237,15 +237,15 @@ to extract the section's title and its unique section ID value.
<indexterm><primary>table of contents</primary>
<secondary>creating</secondary></indexterm>
<para>
You use the <command>dtinfogen tocgen</command> command to create the
You use the <command>dtdocbook2infolib tocgen</command> command to create the
TOCs for each of your books.
</para>
<sect3>
<title id="Sb4E8eBmqJ9X3cS">Running dtinfogen tocgen</title>
<para>Here's an example of using <command>dtinfogen tocgen</command>
<title id="Sb4E8eBmqJ9X3cS">Running dtdocbook2infolib tocgen</title>
<para>Here's an example of using <command>dtdocbook2infolib tocgen</command>
to generate a table of contents.
Before running <command>dtinfogen&nbsp;tocgen</command>,
Before running <command>dtdocbook2infolib tocgen</command>,
ensure that the book&rsquo;s source files:
</para>
<itemizedlist>
@ -263,10 +263,10 @@ Contain valid SGML markup based on the DTD.
</itemizedlist>
<para>
The basic <command>dtinfogen tocgen</command> command line
The basic <command>dtdocbook2infolib tocgen</command> command line
for this example is:</para>
<programlisting>
dtinfogen tocgen -T <replaceable>/usr/pers</replaceable> -f <replaceable>TOC.file</replaceable> -id <replaceable>asg.toc</replaceable> -title <replaceable>&ldquo;Acoustic Sound Generators&rdquo;</replaceable> <replaceable>pref.sgm</replaceable> <replaceable>ch01.sgm</replaceable> <replaceable>ch02.sgm</replaceable> <replaceable>ch03.sgm</replaceable> <replaceable>appx.sgm</replaceable>
dtdocbook2infolib tocgen -T <replaceable>/usr/pers</replaceable> -f <replaceable>TOC.file</replaceable> -id <replaceable>asg.toc</replaceable> -title <replaceable>&ldquo;Acoustic Sound Generators&rdquo;</replaceable> <replaceable>pref.sgm</replaceable> <replaceable>ch01.sgm</replaceable> <replaceable>ch02.sgm</replaceable> <replaceable>ch03.sgm</replaceable> <replaceable>appx.sgm</replaceable>
</programlisting>
<para>
where
@ -289,7 +289,7 @@ If variable <systemitem class="environvar">TMPDIR</systemitem> is not set,
<listitem>
<para>
Specifies the name of the file to which the output of
the <command>dtinfogen tocgen</command> process is sent.
the <command>dtdocbook2infolib tocgen</command> process is sent.
</para>
</listitem>
</varlistentry>
@ -344,12 +344,12 @@ the on-line book.
</varlistentry>
</variablelist>
<para>
The <command>dtinfogen tocgen</command> program validates your
The <command>dtdocbook2infolib tocgen</command> program validates your
document entities against their DTDs, verifying that the
Information Manager architectural forms have been applied.
</para>
<para>
After successful validation, <command>dtinfogen tocgen</command>
After successful validation, <command>dtdocbook2infolib tocgen</command>
then extracts the list of section titles and section identifiers
from the book source files and generates the TOC file.
</para>
@ -406,10 +406,10 @@ for three books.
</itemizedlist>
<para>
Once you have built an information database, you can use
the <command>dtinfogen update</command>
the <command>dtdocbook2infolib update</command>
<indexterm><primary>Information Manager</primary>
<secondary>commands</secondary>
<tertiary>dtinfogen update</tertiary></indexterm>
<tertiary>dtdocbook2infolib update</tertiary></indexterm>
command to reformat the sections using new style sheet information.
See <link linkend="WmNvZbBE6K9X3cS">Updating Style Sheets in Built
Bookcases</link>.
@ -832,7 +832,7 @@ hypertext TOC that conforms to the Information Manager
<filename>dtinfoTOC.dtd</filename>.
</para>
<para>
You can use the <command>dtinfogen tocgen</command> command
You can use the <command>dtdocbook2infolib tocgen</command> command
to produce an Information Manager table of contents.
See <link linkend="n8aJ92dBIsI9X3cS">Creating a Table of Contents</link>.
</para>

120
cde/doc/en_US.UTF-8/guides/infoAPg/ch04.sgm
View file

@ -12,36 +12,36 @@
<indexterm><primary>information libraries</primary>
<secondary>building</secondary></indexterm>
<para>
This chapter discusses how to use <command>dtinfogen</command>
This chapter discusses how to use <command>dtdocbook2infolib</command>
subcommands to validate and
build your SGML documents into an Information Manager-browsable
library and how to update style sheet information in a bookcase.
</para>
<para>
You use the <command>dtinfogen validate</command> command to
You use the <command>dtdocbook2infolib validate</command> command to
validate your SGML book documents and your bookcase specification.
Validation is useful during preparation for the build.
<indexterm><primary>Information Manager</primary>
<secondary>commands</secondary>
<tertiary>dtinfogen validate</tertiary></indexterm>
<tertiary>dtdocbook2infolib validate</tertiary></indexterm>
</para>
<para>
You use the <command>dtinfogen build</command> command,
You use the <command>dtdocbook2infolib build</command> command,
which also performs SGML validation, to build a new information library,
add a bookcase to an existing information library, and update an
existing library.
<indexterm><primary>Information Manager</primary>
<secondary>commands</secondary>
<tertiary>dtinfogen build</tertiary></indexterm>
<tertiary>dtdocbook2infolib build</tertiary></indexterm>
</para>
<para>
Once you have built an information library, you can use
the <command>dtinfogen update</command> command to update the
the <command>dtdocbook2infolib update</command> command to update the
style sheet information associated with the library.
These procedures are covered in:
<indexterm><primary>Information Manager</primary>
<secondary>commands</secondary>
<tertiary>dtinfogen update</tertiary></indexterm>
<tertiary>dtdocbook2infolib update</tertiary></indexterm>
</para>
<itemizedlist>
<listitem>
@ -63,7 +63,7 @@ in a Library</link>
</listitem>
</itemizedlist>
<para>
See the <command>dtinfogen(1)</command> man page for command
See the <command>dtdocbook2infolib(1)</command> man page for command
syntax and additional examples of these commands.
</para>
<sect1>
@ -89,7 +89,7 @@ entity references, or
<listitem>
<para>
Specify the appropriate catalog file using the <option>-m</option>
option with the <command>dtinfogen build</command> command.
option with the <command>dtdocbook2infolib build</command> command.
</para>
</listitem>
</itemizedlist>
@ -100,14 +100,14 @@ Check to make sure that you have all of the required
SGML-conforming documents, including DTD(s), hypertext TOCs,
and style sheet(s) for every book in the bookcase.
You can validate your SGML documents using the
<command>dtinfogen validate</command> command
<command>dtdocbook2infolib validate</command> command
as described in <link linkend="ByGm7JBlsoBt8oL">
Running dtinfogen validate</link>.
Running dtdocbook2infolib validate</link>.
</para>
</listitem>
<listitem>
<para>
Understand the options that <command>dtinfogen build</command> provides,
Understand the options that <command>dtdocbook2infolib build</command> provides,
as described in <link linkend="ki1SgFBr-1698oL">Building,
Adding, and Replacing Bookcases in a Library</link>.
</para>
@ -127,7 +127,7 @@ Depending on whether you are using the
recommendation for resolving external entity references,
you need to set one or both of the following environment variables,
or use the <option>-m</option> option with the
<command>dtinfogen</command> command:</para>
<command>dtdocbook2infolib</command> command:</para>
<variablelist>
<varlistentry>
<term><systemitem class="environvar">SGML_CATALOG_FILES</systemitem></term>
@ -145,7 +145,7 @@ file mapping identifiers.
<para>
If you don't set this environment variable,
you can use the <option>-m</option> option with the
appropriate <command>dtinfogen</command> command to map public
appropriate <command>dtdocbook2infolib</command> command to map public
identifiers and entity names to system files.
See the <filename>catalog(5)</filename> man page for more information.
</para>
@ -157,7 +157,7 @@ See the <filename>catalog(5)</filename> man page for more information.
<para>
Set this environment variable to map external entity references
to system files.</para>
<para>See the <command>dtinfogen(5)</command> man page
<para>See the <command>dtdocbook2infolib(5)</command> man page
for more information.
</para>
</listitem>
@ -182,13 +182,13 @@ for more information.
Before building an information library, you should validate your
SGML documents to ensure that they conform to the appropriate DTD.
</para>
<para>You can use the <command>dtinfogen validate</command>
<para>You can use the <command>dtdocbook2infolib validate</command>
<indexterm><primary>Information Manager</primary>
<secondary>commands</secondary>
<tertiary>dtinfogen validate</tertiary></indexterm>
<tertiary>dtdocbook2infolib validate</tertiary></indexterm>
command to perform SGML validation on bookcase specifications,
on individual documents, or any other SGML conforming document.
During the validation process <command>dtinfogen validate</command>:
During the validation process <command>dtdocbook2infolib validate</command>:
</para>
<itemizedlist>
<listitem>
@ -204,12 +204,12 @@ consistent with the markup language defined in the document's DTD.
</itemizedlist>
<para>
If any documents are found to be invalid, error messages are
issued by the <command>dtinfogen validate</command> program.
issued by the <command>dtdocbook2infolib validate</command> program.
All errors in files used to build an information library must
be corrected before the data can be built.
</para>
<sect2>
<title id="ByGm7JBlsoBt8oL">Running dtinfogen validate</title>
<title id="ByGm7JBlsoBt8oL">Running dtdocbook2infolib validate</title>
<indexterm><primary>information libraries</primary>
<secondary>document validation</secondary></indexterm>
<para>
@ -217,7 +217,7 @@ The basic command line for the following example, which performs
validation on a single-bookcase information library, is:
</para>
<programlisting>
<userinput>dtinfogen validate ch03.sgm ch04.sgm ch05.sgm</userinput>
<userinput>dtdocbook2infolib validate ch03.sgm ch04.sgm ch05.sgm</userinput>
</programlisting>
<para>where</para>
<para>
@ -225,7 +225,7 @@ validation on a single-bookcase information library, is:
</para>
<para>
specifies the SGML documents that are to be validated.
The <command>dtinfogen validate</command> command can be run
The <command>dtdocbook2infolib validate</command> command can be run
against any valid SGML conforming document.
</para>
<para>
@ -235,14 +235,14 @@ example file <filename>ch05.sgm</filename>,
which contains missing or invalid entity declarations.
</para>
<programlisting>
%: <userinput>dtinfogen validate</userinput>
%: <userinput>dtdocbook2infolib validate</userinput>
nsgmls:ch05.sgm:12:1:E: cannot open "hal.gml" (No such file or directory)
nsgmls:ch05.sgm:20:1:E: general entity "tab" not defined and no default entity
..............................
..............................
..............................
dtinfogen: command failed: nsgmls -sg /usr/dt/infolib/C/SGML/dtinfo.decl ch05.sgm
dtdocbook2infolib: command failed: nsgmls -sg /usr/dt/infolib/C/SGML/dtinfo.decl ch05.sgm
ch05.sgm
</programlisting>
</sect2>
@ -254,16 +254,16 @@ ch05.sgm
<title id="ki1SgFBr-1698oL">Building, Adding, and Replacing Bookcases in a Library</title>
<indexterm><primary>information libraries</primary>
<secondary>building</secondary>
<tertiary>with dtinfogen build</tertiary>
<tertiary>with dtdocbook2infolib build</tertiary>
</indexterm>
<para>
This section describes how you use the
<command>dtinfogen build</command> command to build a bookcase
<command>dtdocbook2infolib build</command> command to build a bookcase
into a new information library, add a bookcase to an existing
information library, and update the information database in an
existing library.
<indexterm><primary>Information Manager</primary>
<secondary>commands</secondary><tertiary>dtinfogen build</tertiary>
<secondary>commands</secondary><tertiary>dtdocbook2infolib build</tertiary>
</indexterm>
</para>
@ -346,7 +346,7 @@ The default location for temporary build space is
If you find that the disk space available in
<filename>/usr/tmp</filename> is less than three times the size of the
original document source, you should use the <option>-T</option> option
with the <command>dtinfogen build</command> command to specify a
with the <command>dtdocbook2infolib build</command> command to specify a
different location for the temporary build files, or set the <systemitem
class="environvar">TMPDIR</systemitem> environment variable.
</para>
@ -355,10 +355,10 @@ class="environvar">TMPDIR</systemitem> environment variable.
The current version of the Information Manager has no concurrent-use
locking mechanisms to prevent users from attempting to simultaneously
build or modify the same information library. Take precautions to ensure
that no other <command>dtinfogen</command> or Information Manager
that no other <command>dtdocbook2infolib</command> or Information Manager
processes are accessing the information library when you run the
<command>dtinfogen build</command> command. Concurrent use of the
<command>dtinfogen</command> commands may cause an Information Manager
<command>dtdocbook2infolib build</command> command. Concurrent use of the
<command>dtdocbook2infolib</command> commands may cause an Information Manager
failure.
</para>
</caution>
@ -427,7 +427,7 @@ This directory contains all the files related to the full-text search engine.
<listitem>
<para>
This file organizes the bookcases within the library.
You use the <command>dtinfogen admin</command> command to modify this file.
You use the <command>dtdocbook2infolib admin</command> command to modify this file.
</para>
</listitem>
</varlistentry>
@ -449,11 +449,11 @@ The string used for <replaceable>LIB</replaceable> gives the library its file na
<sect1>
<title id="xXk7ubBtGL9X3cS">Building a New Library</title>
<para>
Here is an example of the basic <command>dtinfogen build</command>
Here is an example of the basic <command>dtdocbook2infolib build</command>
command line for building a new information library:
</para>
<programlisting>
dtinfogen build <option>-T</option> <replaceable>/k1/local/daver/</replaceable> <option>-l</option> <replaceable>InfoLib1 DCE.bc INFOMGR.bc PROG.bc</replaceable>
dtdocbook2infolib build <option>-T</option> <replaceable>/k1/local/daver/</replaceable> <option>-l</option> <replaceable>InfoLib1 DCE.bc INFOMGR.bc PROG.bc</replaceable>
</programlisting>
<para>
where
@ -491,7 +491,7 @@ specification file names on the command line as you wish.
</listitem>
</varlistentry>
</variablelist>
<para><command>dtinfogen build</command> converts the documents
<para><command>dtdocbook2infolib build</command> converts the documents
specified in each of the bookcase specifications into browser-readable
format and places them in the newly created information
library directory <filename>InfoLib1</filename>.
@ -520,18 +520,18 @@ depicts the newly built <filename>InfoLib1</filename> library.
<title id="n7Ktl2IBUXmBt8oL">Adding a Bookcase to an Existing Library</title>
<indexterm><primary>bookcases</primary>
<secondary>adding</secondary>
<tertiary>with dtinfogen build</tertiary></indexterm>
<tertiary>with dtdocbook2infolib build</tertiary></indexterm>
<para>
In addition to creating a new Information Manager information
library, you can also use <command>dtinfogen build</command> to add
library, you can also use <command>dtdocbook2infolib build</command> to add
a bookcase that has not yet been built to an existing information library.
In the example below, assume the argument
<option>-l</option>&nbsp;<replaceable>InfoLib1</replaceable>
<option>-l</option> <replaceable>InfoLib1</replaceable>
is the name of an existing information library rather than the name
of a new information library.
</para>
<programlisting>
dtinfogen build <option>-l</option> <replaceable>InfoLib1 ORA.bc</replaceable></programlisting>
dtdocbook2infolib build <option>-l</option> <replaceable>InfoLib1 ORA.bc</replaceable></programlisting>
<para>
where
</para>
@ -557,7 +557,7 @@ as you wish.
</varlistentry>
</variablelist>
<para>
<command>dtinfogen build</command>
<command>dtdocbook2infolib build</command>
converts the book documents in the bookcase specification file
<filename>ORA.bc</filename> into browser-readable format and adds
them to the existing information library directory
@ -577,9 +577,9 @@ library.
<note>
<para>
Added bookcases are appended to the existing list of bookcases
in the Information Manager Book List. The <command>dtinfogen admin</command>
in the Information Manager Book List. The <command>dtdocbook2infolib admin</command>
command can be used to rearrange the list after it is built.
See the <command>dtinfogen(1)</command> man page.</para>
See the <command>dtdocbook2infolib(1)</command> man page.</para>
</note>
<figure>
<title id="bMUExiBLxJ9X3cS">Adding a Bookcase to an Existing Library</title>
@ -590,19 +590,19 @@ See the <command>dtinfogen(1)</command> man page.</para>
<sect1>
<title id="pOUExiBLxJ9X3cS">Replacing a Bookcase in an Existing Library</title>
<indexterm><primary>bookcases</primary>
<secondary>replacing</secondary><tertiary>with dtinfogen build</tertiary>
<secondary>replacing</secondary><tertiary>with dtdocbook2infolib build</tertiary>
</indexterm>
<para>
In addition to creating information libraries and adding bookcases
to existing libraries, you can also replace specified bookcases
in a library with the <command>dtinfogen build</command> command.
In the example below, the <command>dtinfogen build</command> process
in a library with the <command>dtdocbook2infolib build</command> command.
In the example below, the <command>dtdocbook2infolib build</command> process
is used to rebuild the bookcases <systemitem>INFOMGR</systemitem> and
<systemitem>PROG</systemitem> and to overwrite the existing bookcases
of the same name in the <filename>InfoLib1</filename> information library.
</para>
<programlisting>
dtinfogen build <option>-l</option> <replaceable>InfoLib1 INFOMGR.bc PROG.bc</replaceable></programlisting>
dtdocbook2infolib build <option>-l</option> <replaceable>InfoLib1 INFOMGR.bc PROG.bc</replaceable></programlisting>
<para>
where
</para>
@ -627,7 +627,7 @@ many bookcase specification file names on the command line as you wish.
</listitem>
</varlistentry>
</variablelist>
<para><command>dtinfogen build</command> rebuilds the books in the
<para><command>dtdocbook2infolib build</command> rebuilds the books in the
bookcase specification files <filename>INFOMGR.bc</filename> and
<filename>PROG.bc</filename> and places them in the existing
information library directory <filename>InfoLib1</filename>.
@ -654,7 +654,7 @@ Bookcases in an Existing Library</link> depicts the revised
<indexterm><primary>style sheet</primary>
<secondary>updating</secondary></indexterm>
<indexterm><primary>Information Manager</primary>
<secondary>commands</secondary><tertiary>dtinfogen update</tertiary></indexterm>
<secondary>commands</secondary><tertiary>dtdocbook2infolib update</tertiary></indexterm>
<para>
In Information Manager, you can change the formatting instructions
for existing bookcases without rebuilding those databases.
@ -663,27 +663,27 @@ books whose formatting characteristics must change to meet differing
audience or industry requirements.
</para>
<para>
You use the <command>dtinfogen update</command> command to reformat
You use the <command>dtdocbook2infolib update</command> command to reformat
the books in existing information libraries by updating the style
sheet information that controls their formatting.
</para>
<para>
With <command>dtinfogen update</command> you can revise a style sheet
With <command>dtdocbook2infolib update</command> you can revise a style sheet
and quickly see the results of your changes, or you can replace one
style sheet with another and quickly reformat associated documents.</para>
<para>When you run <command>dtinfogen update</command>, only the
<para>When you run <command>dtdocbook2infolib update</command>, only the
documents or document sections affected by the style sheet changes
are reformatted.
</para>
<para>
Before you run <command>dtinfogen update</command> to reformat documents
Before you run <command>dtdocbook2infolib update</command> to reformat documents
in an information library:
</para>
<itemizedlist>
<listitem>
<para>
Ensure that any changes you have made to the style sheet are valid.
The <command>dtinfogen update</command> command validates the style
The <command>dtdocbook2infolib update</command> command validates the style
sheet file during the update process.
</para>
</listitem>
@ -692,23 +692,23 @@ sheet file during the update process.
Set the appropriate environment variables for handling
external entity references or specify the appropriate catalog file
using the <option>-m</option> option when you run
<command>dtinfogen update</command>.</para>
<command>dtdocbook2infolib update</command>.</para>
</listitem>
</itemizedlist>
<caution>
<para>Do not run the Information Manager or execute an
<command>dtinfogen admin</command> process while updating a style sheet.
<command>dtdocbook2infolib admin</command> process while updating a style sheet.
</para>
</caution>
<sect2>
<title id="CDdVddBydG9X3cS">Running dtinfogen update</title>
<title id="CDdVddBydG9X3cS">Running dtdocbook2infolib update</title>
<para>
The basic command line for the following example,
which reformats the documents and/or document sections
that use the specified style sheet, is:
</para>
<programlisting>
dtinfogen update <option>-l</option> <replaceable>InfoLib1</replaceable> <option>-b</option> <replaceable>INFOMGR style1.sty</replaceable></programlisting>
dtdocbook2infolib update <option>-l</option> <replaceable>InfoLib1</replaceable> <option>-b</option> <replaceable>INFOMGR style1.sty</replaceable></programlisting>
<para>
where
</para>
@ -736,7 +736,7 @@ specified style sheet.
<listitem>
<para>
Is the file name of the style sheet that will be applied
during the <command>dtinfogen update</command> process.
during the <command>dtdocbook2infolib update</command> process.
The style sheet you use must conform to
<filename>StyleSheet.dtd</filename> as discussed
in <link linkend="tgmdnkb6vm9x3cs">Understanding
@ -746,7 +746,7 @@ Information Manager Style Sheets</link>.
</varlistentry>
</variablelist>
<para>
After running <command>dtinfogen update</command> process you can
After running <command>dtdocbook2infolib update</command> process you can
open the information library using the Information Manager Book List
window to see the effect of your changes.
</para>
@ -755,7 +755,7 @@ For related information, see:
</para>
<itemizedlist>
<listitem>
<para>the <command>dtinfogen(1)</command> man page</para>
<para>the <command>dtdocbook2infolib(1)</command> man page</para>
</listitem>
<listitem>
<para><link linkend="TcQg4bBSxI9X3cS">Creating a Bookcase Specification</link>

90
cde/doc/en_US.UTF-8/guides/infoAPg/ch05.sgm
View file

@ -39,18 +39,18 @@ See also
</Para>
<!--(((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<Title id="n01cq1dBePI9X3cS">Running dtinfogen admin</Title>
<Title id="n01cq1dBePI9X3cS">Running dtdocbook2infolib admin</Title>
<IndexTerm><Primary>Information Manager Toolkit</Primary><Secondary>commands</Secondary>
<Tertiary>dtinfogen admin</Tertiary></IndexTerm>
<Tertiary>dtdocbook2infolib admin</Tertiary></IndexTerm>
<Para>
<command>dtinfogen admin</command>
<command>dtdocbook2infolib admin</command>
is an interactive program that displays a menu
from which you select the administrative operation you want to
perform. To run the <Command>dtinfogen admin</Command> command,
perform. To run the <Command>dtdocbook2infolib admin</Command> command,
on the command line type:
</Para>
<ProgramListing>
<UserInput>dtinfogen admin</UserInput>
<UserInput>dtdocbook2infolib admin</UserInput>
</ProgramListing>
<Para>
When you press enter, the following menu appears.</Para>
@ -71,7 +71,7 @@ Please enter your choice [1-6]
<IndexTerm><Primary>bookcases</Primary><Secondary>copying from another library</Secondary></IndexTerm>
<Para>
When you copy a bookcase from another library,
<command>dtinfogen admin</command>
<command>dtdocbook2infolib admin</command>
validates the bookcase you are copying against the bookcases in
the destination library. This ensures that no section IDs are
duplicated within the library, and that the database versions are
@ -79,7 +79,7 @@ compatible with each other.
</Para>
<Para>
If the bookcase you want to copy already exists in the destination
library, <Command>dtinfogen admin</Command> asks whether you wish to replace the
library, <Command>dtdocbook2infolib admin</Command> asks whether you wish to replace the
bookcase.
</Para>
<Para>
@ -87,7 +87,7 @@ To copy a bookcase from another library:
</Para>
<OrderedList>
<ListItem>
<Para>At a command line, enter <UserInput>dtinfogen admin</UserInput>.
<Para>At a command line, enter <UserInput>dtdocbook2infolib admin</UserInput>.
</Para>
<Para>
The following menu appears:
@ -106,7 +106,7 @@ Please enter your choice [1-6]
<Para>On the command line, enter <UserInput>1</UserInput>.
</Para>
<Para>
<command>dtinfogen admin</command> displays:
<command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
Enter the path for the library from which you want to copy a bookcase.
@ -119,7 +119,7 @@ Enter the path to the information library from which you
want to copy a bookcase. For example: <UserInput>/lit/wolfe</UserInput>
</Para>
<Para>
<command>dtinfogen admin</command> displays the bookcases available in the
<command>dtdocbook2infolib admin</command> displays the bookcases available in the
library you specified. For example:
</Para>
<LiteralLayout>
@ -135,7 +135,7 @@ Enter the number associated with the bookcase you want to copy.
<ListItem>
<Para>
At the prompt, enter the number corresponding to the
bookcase you want to copy. <command>dtinfogen admin</command> displays:
bookcase you want to copy. <command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
You specified <Replaceable>[Life]</Replaceable>. Do you really want to copy this bookcase?
@ -155,7 +155,7 @@ want to copy the bookcase. For example:
<UserInput>/lit/destiny</UserInput>
</Para>
<Para>
<command>dtinfogen admin</command> displays the bookcases available in the
<command>dtdocbook2infolib admin</command> displays the bookcases available in the
library you specified:
</Para>
<LiteralLayout>
@ -179,7 +179,7 @@ choose, the bookcase you are copying takes its place, and
the original bookcase moves down one place in the list.
</Para>
<Para>
<command>dtinfogen admin</command> displays the new order of the bookcases in
<command>dtdocbook2infolib admin</command> displays the new order of the bookcases in
the library. For example:
</Para>
<LiteralLayout>
@ -195,7 +195,7 @@ Is this correct? [ynq]
<ListItem>
<Para>
To copy the bookcase into this position, enter
<UserInput>Y</UserInput>. <command>dtinfogen admin</command> saves the addition to the library and returns
<UserInput>Y</UserInput>. <command>dtdocbook2infolib admin</command> saves the addition to the library and returns
to the main menu.
</Para>
</ListItem>
@ -209,16 +209,16 @@ to the main menu.
<IndexTerm><Primary>information libraries</Primary><Secondary>removing bookcases from</Secondary></IndexTerm>
<IndexTerm><Primary>bookcases</Primary><Secondary>removing from a library</Secondary></IndexTerm>
<Para>
The procedure for removing a bookcase with <command>dtinfogen
The procedure for removing a bookcase with <command>dtdocbook2infolib
admin</command> is similar to the procedure for copying a bookcase into
a library. When you remove a bookcase from a library, its database is
deleted from the information library.
</Para>
<Para>
When you specify the library to work with, <Command>dtinfogen
When you specify the library to work with, <Command>dtdocbook2infolib
admin</Command> lists the bookcases found in that library. You simply
specify the bookcase to remove. If the information you supply is valid,
<Command>dtinfogen admin</Command> prompts you for confirmation before
<Command>dtdocbook2infolib admin</Command> prompts you for confirmation before
removing the bookcase you specified.
</Para>
<Para>
@ -227,7 +227,7 @@ To remove a bookcase from a library:
<OrderedList>
<ListItem>
<Para>
At a command line, enter <UserInput>dtinfogen admin</UserInput>.
At a command line, enter <UserInput>dtdocbook2infolib admin</UserInput>.
</Para>
<Para>
The following menu appears.
@ -246,7 +246,7 @@ Please enter your choice [1-6]
<Para>To remove a bookcase, enter <UserInput>2</UserInput>.
</Para>
<Para>
<Command>dtinfogen admin</Command> displays:
<Command>dtdocbook2infolib admin</Command> displays:
</Para>
<LiteralLayout>
Enter the path for the library from which you want to remove a bookcase.
@ -259,7 +259,7 @@ Enter the path to the information library from which you
want to remove the bookcase. For example: <UserInput>/lit/wolfe</UserInput>.
</Para>
<Para>
<Command>dtinfogen admin</Command> displays the bookcases available in the
<Command>dtdocbook2infolib admin</Command> displays the bookcases available in the
library you specified:
</Para>
<LiteralLayout>
@ -276,7 +276,7 @@ Enter the number corresponding to the bookcase to remove.
<Para>
At the prompt, enter the number corresponding to the
bookcase you want to remove.
<Command>dtinfogen admin</Command> displays:
<Command>dtdocbook2infolib admin</Command> displays:
</Para>
<LiteralLayout>
You specified <Replaceable>[Essays]</Replaceable>. Do you really want to remove this bookcase?
@ -284,7 +284,7 @@ You specified <Replaceable>[Essays]</Replaceable>. Do you really want to remove
</ListItem>
<ListItem>
<Para>To remove the bookcase you specified, enter <UserInput>Y</UserInput>.
<Command>dtinfogen admin</Command> removes the bookcase and returns to the
<Command>dtdocbook2infolib admin</Command> removes the bookcase and returns to the
main menu.
</Para>
</ListItem>
@ -305,10 +305,10 @@ To list bookcases in a library:
<OrderedList>
<ListItem>
<Para>At a command line, enter
<UserInput>dtinfogen admin</UserInput>.
<UserInput>dtdocbook2infolib admin</UserInput>.
</Para>
<Para>
<command>dtinfogen admin</command> displays:</Para>
<command>dtdocbook2infolib admin</command> displays:</Para>
<LiteralLayout>
1) Copy a bookcase from another library
2) Remove a bookcase
@ -324,7 +324,7 @@ Please enter your choice [1-6]
To list a bookcase, enter <UserInput>3</UserInput>.
</Para>
<Para>
<command>dtinfogen admin</command> displays:</Para>
<command>dtdocbook2infolib admin</command> displays:</Para>
<LiteralLayout>
Enter the path for the library for which you want to list bookcases.
This can be a relative or absolute path.
@ -336,7 +336,7 @@ Enter the path to the information library for which you
want to list bookcases. For example: <UserInput>/lit/wolfe</UserInput>.
</Para>
<Para>
<command>dtinfogen admin</command> displays the bookcases available in the
<command>dtdocbook2infolib admin</command> displays the bookcases available in the
library you specified. For example:
</Para>
<LiteralLayout>
@ -349,7 +349,7 @@ The bookcases available in /lit/wolfe are:
</ListItem>
<ListItem>
<Para>
After listing the bookcases in the information library, <command>dtinfogen admin</command>
After listing the bookcases in the information library, <command>dtdocbook2infolib admin</command>
returns you to the main menu.
</Para>
</ListItem>
@ -368,10 +368,10 @@ the Information Manager Book List. To rename a bookcase:
<OrderedList>
<ListItem>
<Para>
At a command line, enter <UserInput>dtinfogen admin</UserInput>.
At a command line, enter <UserInput>dtdocbook2infolib admin</UserInput>.
</Para>
<Para>
<command>dtinfogen admin</command> displays:
<command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
1) Copy a bookcase from another library
@ -388,7 +388,7 @@ Please enter your choice [1-6]
To rename a bookcase, enter <UserInput>4</UserInput>.
</Para>
<Para>
<command>dtinfogen admin</command> displays:
<command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
Enter the path for the library containing the bookcase you want to rename.
@ -401,7 +401,7 @@ Enter the path to the information library you want to
rename. For example: <UserInput>/lit/wolfe</UserInput>.
</Para>
<Para>
<command>dtinfogen admin</command> displays the bookcases available in the
<command>dtdocbook2infolib admin</command> displays the bookcases available in the
library you specified:
</Para>
<LiteralLayout>
@ -417,7 +417,7 @@ Enter the number corresponding to the bookcase you want to rename.
<ListItem>
<Para>
At the prompt, enter the number corresponding to the
bookcase you want to rename. <command>dtinfogen admin</command> displays:
bookcase you want to rename. <command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
You specified <Replaceable>[Poems]</Replaceable>. Do you really want to rename the bookcase?
@ -425,7 +425,7 @@ You specified <Replaceable>[Poems]</Replaceable>. Do you really want to rename t
</ListItem>
<ListItem>
<Para>To rename the bookcase you specified, enter <UserInput>Y</UserInput>.
<command>dtinfogen admin</command> asks you to enter the new title for the
<command>dtdocbook2infolib admin</command> asks you to enter the new title for the
bookcase:
</Para>
<LiteralLayout>
@ -435,7 +435,7 @@ Enter the new title for <Replaceable>[Poems]</Replaceable>.
<ListItem>
<Para>
Enter the new title for the bookcase.
<command>dtinfogen admin</command> displays the new title:
<command>dtdocbook2infolib admin</command> displays the new title:
</Para>
<LiteralLayout>You entered <Replaceable>[Old Poems]</Replaceable>. Is this title correct?
</LiteralLayout>
@ -443,7 +443,7 @@ Enter the new title for the bookcase.
<ListItem>
<Para>
To accept the new title, enter <UserInput>Y</UserInput>.
<command>dtinfogen admin</command> saves the
<command>dtdocbook2infolib admin</command> saves the
new title and returns to the main menu.
</Para>
</ListItem>
@ -458,9 +458,9 @@ new title and returns to the main menu.
After you have built a library, you may find that you want to
display the bookcases in a different order in the Information Manager Book List.
Or, you may have added a bookcase using
<Command>dtinfogen build</Command>, and
<Command>dtdocbook2infolib build</Command>, and
want to move it to a different position. You can use
<Command>dtinfogen admin</Command> to
<Command>dtdocbook2infolib admin</Command> to
change the order of bookcases in a library.
</Para>
<Para>
@ -469,10 +469,10 @@ To rearrange bookcases within a library:
<OrderedList>
<ListItem>
<Para>
At a command line, enter <UserInput>dtinfogen admin</UserInput>.
At a command line, enter <UserInput>dtdocbook2infolib admin</UserInput>.
</Para>
<Para>
<command>dtinfogen admin</command> displays:
<command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
1) Copy a bookcase from another library
@ -489,7 +489,7 @@ Please enter your choice [1-6]
To rearrange bookcases within a library, enter <UserInput>5</UserInput>.
</Para>
<Para>
<command>dtinfogen admin</command> displays:
<command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
Enter the path for the library you want to rearrange.
@ -502,7 +502,7 @@ Enter the path to the information library you want to
rearrange. For example: <UserInput>/lit/wolfe</UserInput>.
</Para>
<Para>
<command>dtinfogen admin</command> displays the bookcases available in the
<command>dtdocbook2infolib admin</command> displays the bookcases available in the
library you specified:
</Para>
<LiteralLayout>
@ -518,7 +518,7 @@ Enter the number corresponding to the bookcase you want to move.
<ListItem>
<Para>
At the prompt, enter the number corresponding to the
bookcase you want to move. <command>dtinfogen admin</command> displays:
bookcase you want to move. <command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
You specified <Replaceable>[Poems]</Replaceable>. Do you really want to move this bookcase?
@ -528,7 +528,7 @@ You specified <Replaceable>[Poems]</Replaceable>. Do you really want to move thi
<Para>
To move the bookcase you specified to a different position
in the library, enter <UserInput>Y</UserInput>.
<command>dtinfogen admin</command> displays the current
<command>dtdocbook2infolib admin</command> displays the current
order of the library without the bookcase you selected to
move. For example:
</Para>
@ -553,7 +553,7 @@ choose, the bookcase you are moving takes its place, and
the original bookcase moves one place down in the list.
</Para>
<Para>
<Command>dtinfogen admin</Command> displays the new order of the bookcases in
<Command>dtdocbook2infolib admin</Command> displays the new order of the bookcases in
the library. For example:
</Para>
<LiteralLayout>
@ -569,7 +569,7 @@ Is this correct? [ynq]
<ListItem>
<Para>
To accept the rearranged order, enter <UserInput>Y</UserInput>.
<Command>dtinfogen admin</Command> saves
<Command>dtdocbook2infolib admin</Command> saves
the new order and returns to the main menu.
</Para>
</ListItem>

30
cde/doc/en_US.UTF-8/guides/infoAPg/ch06.sgm
View file

@ -18,28 +18,28 @@ Information Manager tools as a result of:
<ListItem>
<Para>
Build Errors&mdash; these errors can occur during the
<Command>dtinfogen build</Command>,
<Command>dtinfogen tocgen</Command>, and
<Command>dtinfogen update</Command> processes.
<Command>dtdocbook2infolib build</Command>,
<Command>dtdocbook2infolib tocgen</Command>, and
<Command>dtdocbook2infolib update</Command> processes.
</Para>
</ListItem>
<ListItem>
<Para>
Style Sheet Errors&mdash; these errors can occur during the
<Command>dtinfogen build</Command> or the
<Command>dtinfogen update</Command> processes.
<Command>dtdocbook2infolib build</Command> or the
<Command>dtdocbook2infolib update</Command> processes.
</Para>
</ListItem>
<ListItem>
<Para>
Library Administration Errors&mdash; these errors occur
during the <Command>dtinfogen admin</Command> process.
during the <Command>dtdocbook2infolib admin</Command> process.
</Para>
</ListItem>
</ItemizedList>
<Para>
For more information, see <filename>dtinfogen(1)</filename>.
For more information, see <filename>dtdocbook2infolib(1)</filename>.
</Para>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
@ -49,9 +49,9 @@ For more information, see <filename>dtinfogen(1)</filename>.
<Para>
The following error messages are generally associated with the
build process and are generated by either the
<Command>dtinfogen build</Command>,
<Command>dtinfogen tocgen</Command>, or
<Command>dtinfogen update</Command> programs.
<Command>dtdocbook2infolib build</Command>,
<Command>dtdocbook2infolib tocgen</Command>, or
<Command>dtdocbook2infolib update</Command> programs.
</Para>
<para>
The following error message:
@ -389,7 +389,7 @@ the syntax for the Information Manager architectural form.
<Para>
The following error messages are associated with the
<Command>dtinfogen admin</Command> command.
<Command>dtdocbook2infolib admin</Command> command.
</Para>
<para>
The following error message:
@ -416,7 +416,7 @@ The following error message:
</literallayout>
<para>
means that
<Command>dtinfogen admin</Command>
<Command>dtdocbook2infolib admin</Command>
found a problem in the validation phase
and did not copy the bookcase into the destination
library. The problem may be version mismatch or
@ -434,7 +434,7 @@ The following error message:
</literallayout>
<para>
means that
<Command>dtinfogen admin</command>
<Command>dtdocbook2infolib admin</command>
found a database version mismatch in the
bookcase you are copying (<Replaceable>checkbase</Replaceable>) and the bookcase
that exists in the information library (installed base).
@ -451,7 +451,7 @@ The following error message:
</literallayout>
<para>
means that
<Command>dtinfogen admin</Command>
<Command>dtdocbook2infolib admin</Command>
found <Replaceable>ID</Replaceable> in the bookcase you are copying and in
<Replaceable>BookCaseName</Replaceable>, the bookcase into which you are
copying. All IDs must be unique. Change the ID value of
@ -482,7 +482,7 @@ The following error message:
</literallayout>
<para>
means that
<Command>dtinfogen admin</Command> was unable to remove bookcase
<Command>dtdocbook2infolib admin</Command> was unable to remove bookcase
<Replaceable>BookCaseName</Replaceable> from the information library
<Replaceable>InfoLibPath</Replaceable>. Verify that you have the correct
permissions for changing this bookcase. It may be that this bookcase

4
cde/doc/en_US.UTF-8/guides/infoAPg/ch10.sgm
View file

@ -118,7 +118,7 @@ Forms</link>.
<note>
<para>
These architectural forms must be applied before most
<command>dtinfogen</command> subcommands can be used.
<command>dtdocbook2infolib</command> subcommands can be used.
</para>
</note>
<!--)))))))))))))))))))))))))))))))))))))))))-->
@ -274,7 +274,7 @@ Apply the <systemitem>DTINFO.Section</systemitem> form to container
elements that separate pieces of information such as chapters.
Use <systemitem>DTINFO.Section</systemitem> to define which elements
you want displayed to readers as a unit of information in a reading window
of the Information Manager. <command>dtinfogen</command> can derive
of the Information Manager. <command>dtdocbook2infolib</command> can derive
the hierarchy by containment using <systemitem>DTINFO.Section</systemitem>.
</para>
<para>

2
cde/doc/en_US.UTF-8/guides/infoAPg/glossary.sgm
View file

@ -108,7 +108,7 @@ conventions for applying SGML to a document type.
</glossdef>
</Glossentry>
<GlossEntry>
<GlossTerm>dtinfogen</GlossTerm>
<GlossTerm>dtdocbook2infolib</GlossTerm>
<glossdef>
<para>
The on-line document compilation and display system.

2
cde/doc/en_US.UTF-8/guides/infoAPg/preface.sgm
View file

@ -78,7 +78,7 @@ build an information library.
<para>
Chapter 4, &ldquo;Building Information Libraries&rdquo;
covers the process of building and updating an
information library using the <command>dtinfogen</command> commands.
information library using the <command>dtdocbook2infolib</command> commands.
</para>
</listitem>
<listitem>

6
cde/doc/en_US.UTF-8/guides/man/adbook.sgm
View file

@ -685,8 +685,8 @@
<!entity cdeman.dtconfig "<link linkend=CDEMX.MAN7.RSML.1><filename moreinfo=RefEntry>dtconfig</filename>(1)</link>">
<!entity cdeman.dtconvertvf "<link linkend=CDEMX.MAN8.RSML.1><filename moreinfo=RefEntry>dtconvertvf</filename>(1)</link>">
<!entity cdeman.dtdocbook "<link linkend=CDE.INFO.DTDOCBOOK><filename moreinfo=RefEntry>dtdocbook</filename>(1)</link>">
<!entity cdeman.dtinfo "<link linkend=CDE.INFO.DTINFO><filename moreinfo=RefEntry>dtinfo</filename>(1)</link>">
<!entity cdeman.dtdocbook2infolib "<link linkend=CDE.INFO.DTDOCBOOK2INFOLIB><filename moreinfo=RefEntry>dtdocbook2infolib</filename>(1)</link>">
<!entity cdeman.dtinfo "<link linkend=CDE.INFO.DTINFO><filename moreinfo=RefEntry>dtinfo</filename>(1)</link>">
<!entity cdeman.dtcreate "<link linkend=CDEMX.MAN9.RSML.1><filename moreinfo=RefEntry>dtcreate</filename>(1)</link>">
<!entity cdeman.dtsrcreate "<link linkend=CDE.SEARCH.DTSRCREATE><filename moreinfo=RefEntry>dtsrcreate</filename>(1)</link>">
<!entity cdeman.dtsrdbrec "<link linkend=CDE.SEARCH.DTSRDBREC><filename moreinfo=RefEntry>dtsrdbrec</filename>(1)</link>">
@ -1345,8 +1345,8 @@
<!ENTITY manconvertv SYSTEM "./man1_dt/convertv.sgm">
<!ENTITY mandtcreate SYSTEM "./man1_dt/create.sgm">
<!ENTITY mandocbook SYSTEM "./man1_dt/docbook.sgm">
<!ENTITY maninfo SYSTEM "./man1_dt/info.sgm">
<!ENTITY mandocbook2infolib SYSTEM "./man1_dt/docbook2infolib.sgm">
<!ENTITY maninfo SYSTEM "./man1_dt/info.sgm">
<!ENTITY mansrcreate SYSTEM "./man1_dt/srcreate.sgm">
<!ENTITY mansrdbrec SYSTEM "./man1_dt/srdbrec.sgm">
<!ENTITY mansrkdump SYSTEM "./man1_dt/srkdump.sgm">
@ -1999,8 +1999,8 @@
&manconfig;
&manconvertv;
&mandocbook;
&maninfo;
&mandocbook2infolib;
&maninfo;
&mandtcreate;
&mansrcreate;
&mansrdbrec;

4
cde/doc/en_US.UTF-8/guides/man/book.sgm
View file

@ -74,8 +74,8 @@
<!ENTITY manconvertv SYSTEM "./man/man1_dt/convertv.sgm">
<!ENTITY mandtcreate SYSTEM "./man/man1_dt/create.sgm">
<!ENTITY mandocbook SYSTEM "./man/man1_dt/docbook.sgm">
<!ENTITY maninfo SYSTEM "./man/man1_dt/info.sgm">
<!ENTITY mandocbook2infolib SYSTEM "./man/man1_dt/docbook2infolib.sgm">
<!ENTITY maninfo SYSTEM "./man/man1_dt/info.sgm">
<!ENTITY mansrcreate SYSTEM "./man/man1_dt/srcreate.sgm">
<!ENTITY mansrdbrec SYSTEM "./man/man1_dt/srdbrec.sgm">
<!ENTITY mansrkdump SYSTEM "./man/man1_dt/srkdump.sgm">
@ -728,6 +728,7 @@
&manconvertv;
&mandtcreate;
&mandocbook;
&mandocbook2infolib;
&manexec;
&mandtfile;
&manfilecop;
@ -745,7 +746,6 @@
&manicon;
&manimsstart;
&maninfo;
&mandocbook2infolib;
&manksh;
&manlogin;
&manlp;

2
cde/doc/en_US.UTF-8/guides/man/ref1.sgm
View file

@ -25,6 +25,7 @@
<Member><Link LinkEnd="CDEMX.MAN8.RSML.1">dtconvertvf</Link></Member>
<Member><Link LinkEnd="CDEMX.MAN9.RSML.1">dtcreate</Link></Member>
<Member><Link LinkEnd="CDE.INFO.DTDOCBOOK">dtdocbook</Link></Member>
<Member><Link LinkEnd="CDE.INFO.DTDOCBOOK2INFOLIB">dtdocbook2infolib</Link></Member>
<Member><Link LinkEnd="CDEMX.MAN10.RSML.1">dtexec</Link></Member>
<Member><Link LinkEnd="CDEMX.MAN11.RSML.1">dtfile</Link></Member>
<Member><Link LinkEnd="CDEMX.MAN12.RSML.1">dtfile_copy</Link></Member>
@ -42,7 +43,6 @@
<Member><Link LinkEnd="CDEMX.MAN24.RSML.1">dticon</Link></Member>
<Member><Link LinkEnd="CDE.IMS.DTIMSSTART">dtimsstart</Link></Member>
<Member><Link LinkEnd="CDE.INFO.DTINFO">dtinfo</Link></Member>
<Member><Link LinkEnd="CDE.INFO.DTDOCBOOK2INFOLIB">dtdocbook2infolib</Link></Member>
<Member><Link LinkEnd="CDEMX.XCSA.MAN6.RSML.1">dtksh</Link></Member>
<Member><Link LinkEnd="CDEMX.MAN25.RSML.1">dtlogin</Link></Member>
<Member><Link LinkEnd="CDEMX.MAN26.RSML.1">dtlp</Link></Member>

8
cde/doc/ja_JP.UTF-8/guides/infoAPg/ch01.sgm
View file

@ -145,7 +145,7 @@ SGML 文書の<Link Linkend="KyEB2dBpuI9X3cS">「検証」</Link>。
</Para>
</ListItem>
<ListItem>
<Para><Command>dtinfogen build</Command> コマンドを使用して、ブラウザで表示可能なインフォメーション・ライブラリを構築します。
<Para><Command>dtdocbook2infolib build</Command> コマンドを使用して、ブラウザで表示可能なインフォメーション・ライブラリを構築します。
</Para>
<Para>
<Link Linkend="fi1SgFBr-1698oL">「インフォメーション・ライブライの構築」</Link>を参照してください。
@ -157,14 +157,14 @@ SGML 文書の<Link Linkend="KyEB2dBpuI9X3cS">「検証」</Link>。
</Para>
<ItemizedList>
<ListItem>
<Para><Command>dtinfogen update</Command> コマンドを使用して、データベースを再構築せずに、文書データベースに存在するスタイル・シートまたはスタイル・シート情報を置き換えることができます。
<Para><Command>dtdocbook2infolib update</Command> コマンドを使用して、データベースを再構築せずに、文書データベースに存在するスタイル・シートまたはスタイル・シート情報を置き換えることができます。
</Para>
<Para>
<Link Linkend="WmNvZbBE6K9X3cS">「構築されたブックケースのスタイル・シートの更新」</Link> を参照してください。
</Para>
</ListItem>
<ListItem>
<Para><Command>dtinfogen build</Command> コマンドを使用して、ライブラリのブックケースの追加や置換を行うことができます。
<Para><Command>dtdocbook2infolib build</Command> コマンドを使用して、ライブラリのブックケースの追加や置換を行うことができます。
</Para>
<Para>
<Link Linkend="n7Ktl2IBUXmBt8oL">「既存ライブラリへのブックケースの追加」</Link>および
@ -172,7 +172,7 @@ SGML 文書の<Link Linkend="KyEB2dBpuI9X3cS">「検証」</Link>。
</Para>
</ListItem>
<ListItem>
<Para><Command>dtinfogen admin</Command> コマンドを使用して、ライブラリのブックケースのコピー、名称変更、一覧表示、および再調整を行うことができます。
<Para><Command>dtdocbook2infolib admin</Command> コマンドを使用して、ライブラリのブックケースのコピー、名称変更、一覧表示、および再調整を行うことができます。
</Para>
<Para>
<Link Linkend="B7XKbKBcgmg24aK">「ブックケースの管理」</Link>を参照してください。

26
cde/doc/ja_JP.UTF-8/guides/infoAPg/ch03.sgm
View file

@ -32,7 +32,7 @@
<listitem>
<para>
<link linkend="n3NGoZbBosJ9X3cS">「目次ファイル」</link>
インフォメーション・マネージャのブックのそれぞれは、<filename>dtinfoTOC.dtd(5)</filename> に準拠したハイパーテキスト目次 (TOC) を必要とします。ハイパーテキスト目次 (TOC) は、<command>dtinfogen tocgen</command> コマンドを使用して作成することができます。
インフォメーション・マネージャのブックのそれぞれは、<filename>dtinfoTOC.dtd(5)</filename> に準拠したハイパーテキスト目次 (TOC) を必要とします。ハイパーテキスト目次 (TOC) は、<command>dtdocbook2infolib tocgen</command> コマンドを使用して作成することができます。
</para>
</listitem>
<listitem>
@ -91,7 +91,7 @@ SGML 宣言は、SGML のパーサによって必要とされます。これは
</para>
<note>
<para>
インフォメーション・マネージャの SGML 宣言 <filename>dtinfo.decl</filename> は、インフォメーション・マネージャとともに提供され、<command>dtinfogen build</command>、<command>dtinfogen validate</command>、および <command>dtinfogen update</command> コマンドを起動したときには、自動的に参照されます。
インフォメーション・マネージャの SGML 宣言 <filename>dtinfo.decl</filename> は、インフォメーション・マネージャとともに提供され、<command>dtdocbook2infolib build</command>、<command>dtdocbook2infolib validate</command>、および <command>dtdocbook2infolib update</command> コマンドを起動したときには、自動的に参照されます。
</para>
</note>
<figure>
@ -163,12 +163,12 @@ SGML 準拠ドキュメントの作成方法を記述した書籍の一覧につ
<indexterm><primary>目次</primary>
<secondary>作成</secondary></indexterm>
<para>
各ブックのための目次を作成するには、<command>dtinfogen tocgen</command> コマンドを使用します。
各ブックのための目次を作成するには、<command>dtdocbook2infolib tocgen</command> コマンドを使用します。
</para>
<sect3>
<title id="Sb4E8eBmqJ9X3cS">dtinfogen tocgen の実行</title>
<para>ここでは、目次の生成のために <command>dtinfogen tocgen</command> を使用する例を示します。<command>dtinfogen&nbsp;tocgen</command> を実行する前に、ブックのソース・ファイルが次のようになっていることを確認してください。
<title id="Sb4E8eBmqJ9X3cS">dtdocbook2infolib tocgen の実行</title>
<para>ここでは、目次の生成のために <command>dtdocbook2infolib tocgen</command> を使用する例を示します。<command>dtdocbook2infolib&nbsp;tocgen</command> を実行する前に、ブックのソース・ファイルが次のようになっていることを確認してください。
</para>
<itemizedlist>
<listitem>
@ -184,10 +184,10 @@ SGML 準拠ドキュメントの作成方法を記述した書籍の一覧につ
</itemizedlist>
<para>
この例の基本的な <command>dtinfogen tocgen</command> コマンド行を次に示します。
この例の基本的な <command>dtdocbook2infolib tocgen</command> コマンド行を次に示します。
</para>
<programlisting>
dtinfogen tocgen -T <replaceable>/usr/pers</replaceable> -f <replaceable>TOC.file</replaceable> -id <replaceable>asg.toc</replaceable> -title <replaceable>&ldquo;Acoustic Sound Generators&rdquo;</replaceable> <replaceable>pref.sgm</replaceable> <replaceable>ch01.sgm</replaceable> <replaceable>ch02.sgm</replaceable> <replaceable>ch03.sgm</replaceable> <replaceable>appx.sgm</replaceable>
dtdocbook2infolib tocgen -T <replaceable>/usr/pers</replaceable> -f <replaceable>TOC.file</replaceable> -id <replaceable>asg.toc</replaceable> -title <replaceable>&ldquo;Acoustic Sound Generators&rdquo;</replaceable> <replaceable>pref.sgm</replaceable> <replaceable>ch01.sgm</replaceable> <replaceable>ch02.sgm</replaceable> <replaceable>ch03.sgm</replaceable> <replaceable>appx.sgm</replaceable>
</programlisting>
<para>
各オプションの意味は以下のとおりです。
@ -205,7 +205,7 @@ dtinfogen tocgen -T <replaceable>/usr/pers</replaceable> -f <replaceable>TOC.fil
<term><option>-f</option> <replaceable>TOC.file</replaceable></term>
<listitem>
<para>
<command>dtinfogen tocgen</command> プロセスの出力が行われるファイル名を指定します。
<command>dtdocbook2infolib tocgen</command> プロセスの出力が行われるファイル名を指定します。
</para>
</listitem>
</varlistentry>
@ -246,10 +246,10 @@ dtinfogen tocgen -T <replaceable>/usr/pers</replaceable> -f <replaceable>TOC.fil
</varlistentry>
</variablelist>
<para>
<command>dtinfogen tocgen</command> プログラムは、インフォメーション・マネージャ設計様式が適用されたことを検証し、ドキュメント・エンティティをその文書型定義に対して検証します。
<command>dtdocbook2infolib tocgen</command> プログラムは、インフォメーション・マネージャ設計様式が適用されたことを検証し、ドキュメント・エンティティをその文書型定義に対して検証します。
</para>
<para>
検証が正常に行われた後、<command>dtinfogen tocgen</command> は、ブック・ソース・ファイルと生成された目次ファイルから、セクションのタイトルとセクションの識別子を抽出します。
検証が正常に行われた後、<command>dtdocbook2infolib tocgen</command> は、ブック・ソース・ファイルと生成された目次ファイルから、セクションのタイトルとセクションの識別子を抽出します。
</para>
<para>
ブック・ソース・ファイルのセクションの追加や削除を行う場合には、目次を再生成しなければなりません。
@ -288,8 +288,8 @@ dtinfogen tocgen -T <replaceable>/usr/pers</replaceable> -f <replaceable>TOC.fil
</listitem>
</itemizedlist>
<para>
インフォメーション・データベースを一度構築すれば、<command>dtinfogen update</command>
<indexterm><primary>インフォメーション・マネージャ</primary><secondary>コマンド</secondary><tertiary>dtinfogen update</tertiary></indexterm>
インフォメーション・データベースを一度構築すれば、<command>dtdocbook2infolib update</command>
<indexterm><primary>インフォメーション・マネージャ</primary><secondary>コマンド</secondary><tertiary>dtdocbook2infolib update</tertiary></indexterm>
コマンドを使用して、新規のスタイル・シート情報によるセクションの再フォーマットを行うことができます。
<link linkend="WmNvZbBE6K9X3cS">「構築されたブックケースのスタイル・シートの更新」</link>を参照してください。
</para>
@ -637,7 +637,7 @@ BOOK 要素の開始タグは、ブックの内容の一覧表記を開始し、
ブックケース規定において定義される各ブックは、インフォメーション・マネージャの <filename>dtinfoTOC.dtd</filename> に準拠するハイパーテキスト目次がなければなりません。
</para>
<para>
<command>dtinfogen tocgen</command> コマンドを使用して、インフォメーション・マネージャの目次を作成することができます。
<command>dtdocbook2infolib tocgen</command> コマンドを使用して、インフォメーション・マネージャの目次を作成することができます。
<link linkend="n8aJ92dBIsI9X3cS">「目次の作成」</link>を参照してください。
</para>
</listitem>

110
cde/doc/ja_JP.UTF-8/guides/infoAPg/ch04.sgm
View file

@ -12,25 +12,25 @@
<indexterm><primary>インフォメーション・ライブラリ</primary>
<secondary>構築</secondary></indexterm>
<para>
この章では、SGML ドキュメントを検証してインフォメーション・マネージャでブラウズ可能なライブラリを構築するための <command>dtinfogen</command> サブコマンドの使用方法、およびブックケースのスタイル・シート情報を更新する方法について説明します。
この章では、SGML ドキュメントを検証してインフォメーション・マネージャでブラウズ可能なライブラリを構築するための <command>dtdocbook2infolib</command> サブコマンドの使用方法、およびブックケースのスタイル・シート情報を更新する方法について説明します。
</para>
<para>
<command>dtinfogen validate</command> コマンドを使用して、SGML ブック・ドキュメントおよびブックケース規定を検証します。検証は、構築のための準備期間に有用です。
<command>dtdocbook2infolib validate</command> コマンドを使用して、SGML ブック・ドキュメントおよびブックケース規定を検証します。検証は、構築のための準備期間に有用です。
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary>
<tertiary>dtinfogen validate</tertiary></indexterm>
<tertiary>dtdocbook2infolib validate</tertiary></indexterm>
</para>
<para>
<command>dtinfogen build</command> コマンドを使用して、SGML の検証実行はもとより、新規インフォメーション・ライブラリの構築、既存インフォメーション・ライブラリへのブックケース追加、および既存ライブラリの更新を行います。
<command>dtdocbook2infolib build</command> コマンドを使用して、SGML の検証実行はもとより、新規インフォメーション・ライブラリの構築、既存インフォメーション・ライブラリへのブックケース追加、および既存ライブラリの更新を行います。
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary>
<tertiary>dtinfogen build</tertiary></indexterm>
<tertiary>dtdocbook2infolib build</tertiary></indexterm>
</para>
<para>
インフォメーション・ライブラリを一度構築すれば、<command>dtinfogen update</command> コマンドを使用して、ライブラリに関連するスタイル・シート情報を更新することができます。これらの手続きは、次で説明しています。
インフォメーション・ライブラリを一度構築すれば、<command>dtdocbook2infolib update</command> コマンドを使用して、ライブラリに関連するスタイル・シート情報を更新することができます。これらの手続きは、次で説明しています。
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary>
<tertiary>dtinfogen update</tertiary></indexterm>
<tertiary>dtdocbook2infolib update</tertiary></indexterm>
</para>
<itemizedlist>
<listitem>
@ -50,7 +50,7 @@
</listitem>
</itemizedlist>
<para>
コマンドの構文およびこれらのコマンドの例については、<command>dtinfogen(1)</command> マニュアル・ページを参照してください。
コマンドの構文およびこれらのコマンドの例については、<command>dtdocbook2infolib(1)</command> マニュアル・ページを参照してください。
</para>
<sect1>
<title id="WxGm7JBlsoBt8oL">新規ライブラリ構築の前に</title>
@ -72,19 +72,19 @@
</listitem>
<listitem>
<para>
<command>dtinfogen build</command> コマンドの <option>-m</option> オプションを使用して、適切なカタログ・ファイルを指定します。
<command>dtdocbook2infolib build</command> コマンドの <option>-m</option> オプションを使用して、適切なカタログ・ファイルを指定します。
</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>
必要な SGML 準拠ドキュメントがすべて揃っているか確認します。これには、ブックケースの各ブックのための文書型定義、ハイパーテキスト目次、およびスタイル・シートが含まれます。<link linkend="ByGm7JBlsoBt8oL">「dtinfogen validate の実行」</link> で説明しているように、<command>dtinfogen validate</command> コマンドを使用して、SGML ドキュメントを検証することができます。
必要な SGML 準拠ドキュメントがすべて揃っているか確認します。これには、ブックケースの各ブックのための文書型定義、ハイパーテキスト目次、およびスタイル・シートが含まれます。<link linkend="ByGm7JBlsoBt8oL">「dtdocbook2infolib validate の実行」</link> で説明しているように、<command>dtdocbook2infolib validate</command> コマンドを使用して、SGML ドキュメントを検証することができます。
</para>
</listitem>
<listitem>
<para>
<link linkend="ki1SgFBr-1698oL">「ライブラリのブックケースの構築、追加、およぴ更新」</link> で説明しているように、<command>dtinfogen build</command> のオプションを理解します。
<link linkend="ki1SgFBr-1698oL">「ライブラリのブックケースの構築、追加、およぴ更新」</link> で説明しているように、<command>dtdocbook2infolib build</command> のオプションを理解します。
</para>
</listitem>
</itemizedlist>
@ -97,7 +97,7 @@
<indexterm><primary>環境変数</primary></indexterm>
<para>
ユーザが、<citetitle>SGML Open Technical Resolution 9401:1994</citetitle> の外部エンティティ参照に関する推奨を使用しているかどうかに依存して、以下の環境変数のひとつまたは両方を設定するか、<command>dtinfogen</command> コマンドの <option>-m</option> オプションを使用する必要があります。
ユーザが、<citetitle>SGML Open Technical Resolution 9401:1994</citetitle> の外部エンティティ参照に関する推奨を使用しているかどうかに依存して、以下の環境変数のひとつまたは両方を設定するか、<command>dtdocbook2infolib</command> コマンドの <option>-m</option> オプションを使用する必要があります。
</para>
<variablelist>
<varlistentry>
@ -107,7 +107,7 @@
<citetitle>SGML Open Technical Resolution 9401:1994</citetitle> の外部エンティティ管理に関連する推奨にしたがっている場合は、この環境変数を設定してください。この環境変数の値は、SGML エンティティ宣言の一覧表記とファイル・マッピング識別子がある <filename>catalog</filename> または <filename>CATALOG</filename>（大文字、小文字どちらでも使用することができます）の位置を指定します。
</para>
<para>
環境変数を設定しない場合は、適切な <command>dtinfogen</command> コマンドの <option>-m</option> オプションを使用して、パブリックな識別子とエンティティ名をシステム・ファイルにマップすることができます。
環境変数を設定しない場合は、適切な <command>dtdocbook2infolib</command> コマンドの <option>-m</option> オプションを使用して、パブリックな識別子とエンティティ名をシステム・ファイルにマップすることができます。
詳細については、<filename>catalog(5)</filename> マニュアル・ページを参照してください。
</para>
</listitem>
@ -118,7 +118,7 @@
<para>
外部エンティティ参照をシステム・ファイルにマップするときに、この環境変数を設定します。
</para>
<para>詳細については、<command>dtinfogen(5)</command> マニュアル・ページを参照してください。
<para>詳細については、<command>dtdocbook2infolib(5)</command> マニュアル・ページを参照してください。
</para>
</listitem>
</varlistentry>
@ -141,11 +141,11 @@
<para>
インフォメーション・ライブラリを構築する前に、適切な文書型定義にしたがっているか確認するために、SGML ドキュメントを検証しなければなりません。 </para>
<para>
<command>dtinfogen validate</command>
<command>dtdocbook2infolib validate</command>
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary>
<tertiary>dtinfogen validate</tertiary></indexterm>
コマンドを使用して、ブックケース規定、個別のドキュメント、および他の SGML 準拠ドキュメントの SGML 検証を行うことができます。検証過程において、<command>dtinfogen validate</command> は、次に示すことを実行します。
<tertiary>dtdocbook2infolib validate</tertiary></indexterm>
コマンドを使用して、ブックケース規定、個別のドキュメント、および他の SGML 準拠ドキュメントの SGML 検証を行うことができます。検証過程において、<command>dtdocbook2infolib validate</command> は、次に示すことを実行します。
</para>
<itemizedlist>
<listitem>
@ -160,37 +160,37 @@ SGML にしたがっていることを検証するために、入力ドキュメ
</listitem>
</itemizedlist>
<para>
無効なドキュメントを検出した場合には、<command>dtinfogen validate</command> プログラムによってエラー・メーセージが出力されます。インフォメーション・ライブラリを構築するときに使用されるファイルのエラーは、データが構築される前に、すべて修正されなければなりません。
無効なドキュメントを検出した場合には、<command>dtdocbook2infolib validate</command> プログラムによってエラー・メーセージが出力されます。インフォメーション・ライブラリを構築するときに使用されるファイルのエラーは、データが構築される前に、すべて修正されなければなりません。
</para>
<sect2>
<title id="ByGm7JBlsoBt8oL">dtinfogen validate の実行</title>
<title id="ByGm7JBlsoBt8oL">dtdocbook2infolib validate の実行</title>
<indexterm><primary>インフォメーション・ライブラリ</primary>
<secondary>ドキュメントの検証</secondary></indexterm>
<para>
次に示す例の基本的なコマンド行（これは、単一ブックケースのインフォメーション・ライブラリの検証を実行します）は、以下のとおりです。
</para>
<programlisting>
<userinput>dtinfogen validate ch03.sgm ch04.sgm ch05.sgm</userinput>
<userinput>dtdocbook2infolib validate ch03.sgm ch04.sgm ch05.sgm</userinput>
</programlisting>
<para>以下に、引き数の説明を示します。</para>
<para>
<filename>ch03.sgm ch04.sgm ch05.sgm</filename>
</para>
<para>
検証すべき SGML ドキュメントを指定します。<command>dtinfogen validate</command> コマンドは、いかなる有効な SGML 準拠ドキュメントに対しても実行することができます。
検証すべき SGML ドキュメントを指定します。<command>dtdocbook2infolib validate</command> コマンドは、いかなる有効な SGML 準拠ドキュメントに対しても実行することができます。
</para>
<para>
ドキュメントが無効な場合は、エラー・メッセージが返されます。例のファイル <filename>ch05.sgm</filename> に対して返されたエラーの型の例を、次に示します。これには、不足あるいは無効のエンティティ宣言があります。
</para>
<programlisting>
%: <userinput>dtinfogen validate</userinput>
%: <userinput>dtdocbook2infolib validate</userinput>
nsgmls:ch05.sgm:12:1:E: cannot open "hal.gml" (No such file or directory)
nsgmls:ch05.sgm:20:1:E: general entity "tab" not defined and no default entity
..............................
..............................
..............................
dtinfogen: command failed: nsgmls -sg /usr/dt/infolib/C/SGML/dtinfo.decl ch05.sgm
dtdocbook2infolib: command failed: nsgmls -sg /usr/dt/infolib/C/SGML/dtinfo.decl ch05.sgm
ch05.sgm
</programlisting>
</sect2>
@ -202,12 +202,12 @@ ch05.sgm
<title id="ki1SgFBr-1698oL">ライブラリのブックケースの構築、追加、および置換</title>
<indexterm><primary>インフォメーション・ライブラリ</primary>
<secondary>構築</secondary>
<tertiary>dtinfogen build</tertiary>
<tertiary>dtdocbook2infolib build</tertiary>
</indexterm>
<para>
本節では、ブックケースの新規インフォメーション・ライブラリへの構築、既存のインフォメーション・ライブラリへのブックケースの追加、および既存のライブラリのインフォメーション・データベースの更新を行うための <command>dtinfogen build</command> コマンドの使用方法について説明します。
本節では、ブックケースの新規インフォメーション・ライブラリへの構築、既存のインフォメーション・ライブラリへのブックケースの追加、および既存のライブラリのインフォメーション・データベースの更新を行うための <command>dtdocbook2infolib build</command> コマンドの使用方法について説明します。
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary><tertiary>dtinfogen build</tertiary>
<secondary>コマンド</secondary><tertiary>dtdocbook2infolib build</tertiary>
</indexterm>
</para>
@ -260,11 +260,11 @@ ch05.sgm
構築が完了すると、インフォメーション・ライブラリは、構築の元になったソースとほぼ同じ容量のスペースを占めます。しかしながら、構築過程そのものについては、一時的ファイルの記憶領域として、最大３倍の追加スペースが必要です。この追加スペースは、構築完了時に自動的に削除される一時的な構築スペースとして確保しなければなりません。一時的な構築スペースのデフォルトは、<filename>/usr/tmp</filename> に確保されます。
</para>
<para>
<filename>/usr/tmp</filename> で使用可能なディスク・スペースが、元のドキュメント・ソースのサイズの３倍よりも小さい場合、<command>dtinfogen build</command> コマンドの <option>-T</option> オプションを使用して、一時的な構築ファイルのために別の場所を指定するか、 <systemitem class="environvar">TMPDIR</systemitem> 環境変数を設定しなければなりません。
<filename>/usr/tmp</filename> で使用可能なディスク・スペースが、元のドキュメント・ソースのサイズの３倍よりも小さい場合、<command>dtdocbook2infolib build</command> コマンドの <option>-T</option> オプションを使用して、一時的な構築ファイルのために別の場所を指定するか、 <systemitem class="environvar">TMPDIR</systemitem> 環境変数を設定しなければなりません。
</para>
<caution>
<para>
インフォメーション・マネージャの現在のバージョンには、ユーザが同じインフォメーション・ライブラリの構築や修正を同時に行うことを回避する同時使用のロック機構がありません。<command>dtinfogen build</command> コマンドを実行するときには、他の <command>dtinfogen</command> やインフォメーション・マネージャのプロセスが、インフォメーション・ライブラリにアクセスしないことを確認するため、事前に注意を払ってください。<command>dtinfogen</command> コマンドの同時使用は、インフォメーション・マネージャの失敗をもたらします。
インフォメーション・マネージャの現在のバージョンには、ユーザが同じインフォメーション・ライブラリの構築や修正を同時に行うことを回避する同時使用のロック機構がありません。<command>dtdocbook2infolib build</command> コマンドを実行するときには、他の <command>dtdocbook2infolib</command> やインフォメーション・マネージャのプロセスが、インフォメーション・ライブラリにアクセスしないことを確認するため、事前に注意を払ってください。<command>dtdocbook2infolib</command> コマンドの同時使用は、インフォメーション・マネージャの失敗をもたらします。
</para>
</caution>
</sect3>
@ -326,7 +326,7 @@ ch05.sgm
<term><filename>bookcase.map</filename></term>
<listitem>
<para>
このファイルは、ブックケースをライブラリ内に編成します。<command>dtinfogen admin</command> コマンドを使用して、このファイルを修正することができます。
このファイルは、ブックケースをライブラリ内に編成します。<command>dtdocbook2infolib admin</command> コマンドを使用して、このファイルを修正することができます。
</para>
</listitem>
</varlistentry>
@ -348,10 +348,10 @@ ch05.sgm
<sect1>
<title id="xXk7ubBtGL9X3cS">新規ライブラリの構築</title>
<para>
新規のインフォメーション・ライブラリ構築のための基本的な <command>dtinfogen build</command> コマンド行の例を、次に示します。
新規のインフォメーション・ライブラリ構築のための基本的な <command>dtdocbook2infolib build</command> コマンド行の例を、次に示します。
</para>
<programlisting>
dtinfogen build <option>-T</option> <replaceable>/k1/local/daver/</replaceable> <option>-l</option> <replaceable>InfoLib1 DCE.bc INFOMGR.bc PROG.bc</replaceable>
dtdocbook2infolib build <option>-T</option> <replaceable>/k1/local/daver/</replaceable> <option>-l</option> <replaceable>InfoLib1 DCE.bc INFOMGR.bc PROG.bc</replaceable>
</programlisting>
<para>
各オプションの意味を、以下に示します。
@ -383,7 +383,7 @@ dtinfogen build <option>-T</option> <replaceable>/k1/local/daver/</replaceable>
</varlistentry>
</variablelist>
<para>
<command>dtinfogen build</command> コマンドは、ブックケース規定のそれぞれで指定されたドキュメントをブラウザで表示可能なフォーマットに変換し、それらを新規に作成されたインフォメーション・ライブラリのディレクトリ <filename>InfoLib1</filename> に置きます。
<command>dtdocbook2infolib build</command> コマンドは、ブックケース規定のそれぞれで指定されたドキュメントをブラウザで表示可能なフォーマットに変換し、それらを新規に作成されたインフォメーション・ライブラリのディレクトリ <filename>InfoLib1</filename> に置きます。
</para>
<para>
３つのブックケースの名前を（それぞれのブックケースの BOOKCASENAME 要素で指定されるように）それぞれ <systemitem>DCE</systemitem>、<systemitem>INFOMGR</systemitem>、および <systemitem>PROG</systemitem> とすると、<filename>InfoLib1</filename> ディレクトリ下に、ブックケースのディレクトリ <filename>DCE</filename>、<filename>INFOMGR</filename>、および <filename>PROG</filename> が生成されます。その一方、各ブックケースには、その BOOK 要素で指定されるドキュメント・データベース（ブック）が含まれます。
@ -401,12 +401,12 @@ dtinfogen build <option>-T</option> <replaceable>/k1/local/daver/</replaceable>
<title id="n7Ktl2IBUXmBt8oL">既存ライブラリへのブックケース追加</title>
<indexterm><primary>ブックケース</primary>
<secondary>追加</secondary>
<tertiary>dtinfogen build</tertiary></indexterm>
<tertiary>dtdocbook2infolib build</tertiary></indexterm>
<para>
インフォメーション・マネージャの新規インフォメーション・ライブラリ作成に加えて、<command>dtinfogen build</command> を使用して、既存のインフォメーション・ライブラリにまだ構築されていないブックケースを追加することもできます。以下に示す例では、引き数 <option>-l</option>&nbsp;<replaceable>InfoLib1</replaceable> が、新規のインフォメーション・ライブラリではなく、既存のインフォメーション・ライブラリの名前であることを仮定しています。
インフォメーション・マネージャの新規インフォメーション・ライブラリ作成に加えて、<command>dtdocbook2infolib build</command> を使用して、既存のインフォメーション・ライブラリにまだ構築されていないブックケースを追加することもできます。以下に示す例では、引き数 <option>-l</option>&nbsp;<replaceable>InfoLib1</replaceable> が、新規のインフォメーション・ライブラリではなく、既存のインフォメーション・ライブラリの名前であることを仮定しています。
</para>
<programlisting>
dtinfogen build <option>-l</option> <replaceable>InfoLib1 ORA.bc</replaceable></programlisting>
dtdocbook2infolib build <option>-l</option> <replaceable>InfoLib1 ORA.bc</replaceable></programlisting>
<para>
以下に説明を示します。
</para>
@ -429,7 +429,7 @@ dtinfogen build <option>-l</option> <replaceable>InfoLib1 ORA.bc</replaceable></
</varlistentry>
</variablelist>
<para>
<command>dtinfogen build</command>
<command>dtdocbook2infolib build</command>
これは、ブックケース規定ファイル <filename>ORA.bc</filename> のブック・ドキュメントを、ブラウザで表示可能なフォーマットに変換し、それらを既存のインフォメーション・ライブラリのディレクトリ <filename>InfoLib1</filename> に追加します。
</para>
<para>
@ -440,9 +440,9 @@ dtinfogen build <option>-l</option> <replaceable>InfoLib1 ORA.bc</replaceable></
</para>
<note>
<para>
追加されるブックケースは、インフォメーション・マネージャのブック・リスト中の既存のブックケースのリストの末尾に追加されます。<command>dtinfogen admin</command>
追加されるブックケースは、インフォメーション・マネージャのブック・リスト中の既存のブックケースのリストの末尾に追加されます。<command>dtdocbook2infolib admin</command>
コマンドを使用して、構築後にリストの再調整を行うことができます。
<command>dtinfogen(1)</command> マニュアル・ページを参照してください。
<command>dtdocbook2infolib(1)</command> マニュアル・ページを参照してください。
</para>
</note>
<figure>
@ -454,13 +454,13 @@ dtinfogen build <option>-l</option> <replaceable>InfoLib1 ORA.bc</replaceable></
<sect1>
<title id="pOUExiBLxJ9X3cS">既存のライブラリのブックケースの置換</title>
<indexterm><primary>ブックケース</primary>
<secondary>置換</secondary><tertiary>dtinfogen build</tertiary>
<secondary>置換</secondary><tertiary>dtdocbook2infolib build</tertiary>
</indexterm>
<para>
インフォメーション・ライブラリの作成および既存のライブラリへのブックケース追加に加えて、<command>dtinfogen build</command> コマンドで、ライブラリの指定されたブックケースを置換することもできます。以下に示す例では、<command>dtinfogen build</command> プロセスが、ブックケース <systemitem>INFOMGR</systemitem> および <systemitem>PROG</systemitem> の再構築と <filename>InfoLib1</filename> インフォメーション・ライブラリにある同じ名前の既存ブックケースの上書きを行うために使用されています。
インフォメーション・ライブラリの作成および既存のライブラリへのブックケース追加に加えて、<command>dtdocbook2infolib build</command> コマンドで、ライブラリの指定されたブックケースを置換することもできます。以下に示す例では、<command>dtdocbook2infolib build</command> プロセスが、ブックケース <systemitem>INFOMGR</systemitem> および <systemitem>PROG</systemitem> の再構築と <filename>InfoLib1</filename> インフォメーション・ライブラリにある同じ名前の既存ブックケースの上書きを行うために使用されています。
</para>
<programlisting>
dtinfogen build <option>-l</option> <replaceable>InfoLib1 INFOMGR.bc PROG.bc</replaceable></programlisting>
dtdocbook2infolib build <option>-l</option> <replaceable>InfoLib1 INFOMGR.bc PROG.bc</replaceable></programlisting>
<para>
各オプションの説明を、以下に示します。
</para>
@ -483,7 +483,7 @@ dtinfogen build <option>-l</option> <replaceable>InfoLib1 INFOMGR.bc PROG.bc</re
</varlistentry>
</variablelist>
<para>
<command>dtinfogen build</command> は、ブックケース規定ファイル <filename>INFOMGR.bc</filename> および <filename>PROG.bc</filename> のブックを再構築し、それらを既存のインフォメーション・ライブラリのディレクトリ <filename>InfoLib1</filename> に置きます。
<command>dtdocbook2infolib build</command> は、ブックケース規定ファイル <filename>INFOMGR.bc</filename> および <filename>PROG.bc</filename> のブックを再構築し、それらを既存のインフォメーション・ライブラリのディレクトリ <filename>InfoLib1</filename> に置きます。
</para>
<para>
そのブックケース名が（それぞれの BOOKCASENAME 要素で指定されているように）<systemitem>INFOMGR</systemitem> および <systemitem>PROG</systemitem> である新規に構築されたブックケースは、同じ名前をもつ既存のブックケースを上書きします。
@ -502,46 +502,46 @@ dtinfogen build <option>-l</option> <replaceable>InfoLib1 INFOMGR.bc PROG.bc</re
<indexterm><primary>スタイル・シート</primary>
<secondary>更新</secondary></indexterm>
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary><tertiary>dtinfogen update</tertiary></indexterm>
<secondary>コマンド</secondary><tertiary>dtdocbook2infolib update</tertiary></indexterm>
<para>
インフォメーション・マネージャでは、そのデータベースを再構築せずに、既存のブックケースのフォーマット指定を変更することができます。この機能によって、異なる読者や製造要件に合致するように、フォーマット属性を変更しなければならないブックを処理するときに、柔軟な対処が可能になります。
</para>
<para>
<command>dtinfogen update</command> コマンドを使用して、フォーマットを管理するスタイル・シート情報を更新することによって、既存のインフォメーション・ライブラリのブックの再フォーマットを行います。
<command>dtdocbook2infolib update</command> コマンドを使用して、フォーマットを管理するスタイル・シート情報を更新することによって、既存のインフォメーション・ライブラリのブックの再フォーマットを行います。
</para>
<para>
<command>dtinfogen update</command> によって、スタイル・シートを更新してその変更の結果をすばやく確認したり、あるスタイル・シートを別のものに置き換えて関連するドキュメントの再フォーマットをすばやく行うことができます。
<command>dtdocbook2infolib update</command> によって、スタイル・シートを更新してその変更の結果をすばやく確認したり、あるスタイル・シートを別のものに置き換えて関連するドキュメントの再フォーマットをすばやく行うことができます。
</para>
<para>
<command>dtinfogen update</command> を実行すると、スタイル・シートの変更によって影響を受けるドキュメントあるいはドキュメントのセクションのみが再フォーマットされます。
<command>dtdocbook2infolib update</command> を実行すると、スタイル・シートの変更によって影響を受けるドキュメントあるいはドキュメントのセクションのみが再フォーマットされます。
</para>
<para>
<command>dtinfogen update</command> を実行して、インフォメーション・ライブラリのドキュメントを再フォーマットする前に、次のことを行います。
<command>dtdocbook2infolib update</command> を実行して、インフォメーション・ライブラリのドキュメントを再フォーマットする前に、次のことを行います。
</para>
<itemizedlist>
<listitem>
<para>
スタイル・シートに対して行った変更が有効なものであることを確認します。<command>dtinfogen update</command> コマンドは、更新過程において、スタイル・シートのファイルを検証します。
スタイル・シートに対して行った変更が有効なものであることを確認します。<command>dtdocbook2infolib update</command> コマンドは、更新過程において、スタイル・シートのファイルを検証します。
</para>
</listitem>
<listitem>
<para>
<command>dtinfogen update</command> を実行するときに、外部エンティティ参照を処理するための適切な環境変数の設定、あるいは、<option>-m</option> オプションの使用による適切なカタログ・ファイルの指定を行います。
<command>dtdocbook2infolib update</command> を実行するときに、外部エンティティ参照を処理するための適切な環境変数の設定、あるいは、<option>-m</option> オプションの使用による適切なカタログ・ファイルの指定を行います。
</para>
</listitem>
</itemizedlist>
<caution>
<para>
スタイル・シートを更新しているときには、インフォメーション・マネージャや <command>dtinfogen admin</command> プロセスを実行してはいけません。
スタイル・シートを更新しているときには、インフォメーション・マネージャや <command>dtdocbook2infolib admin</command> プロセスを実行してはいけません。
</para>
</caution>
<sect2>
<title id="CDdVddBydG9X3cS">dtinfogen update の実行</title>
<title id="CDdVddBydG9X3cS">dtdocbook2infolib update の実行</title>
<para>
次に示す例の基本的なコマンド行は以下のとおりです。この例は、指定されたスタイル・シートを使用するドキュメントあるいはドキュメントのセクションを再フォーマットするものです。
</para>
<programlisting>
dtinfogen update <option>-l</option> <replaceable>InfoLib1</replaceable> <option>-b</option> <replaceable>INFOMGR style1.sty</replaceable></programlisting>
dtdocbook2infolib update <option>-l</option> <replaceable>InfoLib1</replaceable> <option>-b</option> <replaceable>INFOMGR style1.sty</replaceable></programlisting>
<para>各オプションの意味を、以下に示します。
</para>
<variablelist>
@ -565,20 +565,20 @@ dtinfogen update <option>-l</option> <replaceable>InfoLib1</replaceable> <option
<term><replaceable>style1.sty</replaceable></term>
<listitem>
<para>
これは、<command>dtinfogen update</command> のプロセスにおいて、適用されるスタイル・シートのファイル名です。使用するスタイル・シートは、<link linkend="tgmdnkb6vm9x3cs">「インフォメーション・マネージャのスタイル・シートの理解」</link> で説明しているように <filename>StyleSheet.dtd</filename> に準拠していなければなりません。
これは、<command>dtdocbook2infolib update</command> のプロセスにおいて、適用されるスタイル・シートのファイル名です。使用するスタイル・シートは、<link linkend="tgmdnkb6vm9x3cs">「インフォメーション・マネージャのスタイル・シートの理解」</link> で説明しているように <filename>StyleSheet.dtd</filename> に準拠していなければなりません。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>
<command>dtinfogen update</command> のプロセスを実行した後、変更の効果を確認するために、インフォメーション・マネージャのブック・リスト・ウィンドウを使用してインフォメーション・ライブラリを開くことができます。
<command>dtdocbook2infolib update</command> のプロセスを実行した後、変更の効果を確認するために、インフォメーション・マネージャのブック・リスト・ウィンドウを使用してインフォメーション・ライブラリを開くことができます。
</para>
<para>
関連情報については、以下を参照してください。
</para>
<itemizedlist>
<listitem>
<para><command>dtinfogen(1)</command> マニュアル・ページ</para>
<para><command>dtdocbook2infolib(1)</command> マニュアル・ページ</para>
</listitem>
<listitem>
<para><link linkend="TcQg4bBSxI9X3cS">「ブックケース規定の作成」</link>

84
cde/doc/ja_JP.UTF-8/guides/infoAPg/ch05.sgm
View file

@ -36,14 +36,14 @@
</Para>
<!--(((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<Title id="n01cq1dBePI9X3cS">dtinfogen admin の実行</Title>
<Title id="n01cq1dBePI9X3cS">dtdocbook2infolib admin の実行</Title>
<IndexTerm><Primary>インフォメーション・マネージャ・ツールキット</Primary><Secondary>コマンド</Secondary>
<Tertiary>dtinfogen admin</Tertiary></IndexTerm>
<Tertiary>dtdocbook2infolib admin</Tertiary></IndexTerm>
<Para>
<command>dtinfogen admin</command> は、実行する管理操作を選択できるメニューを表示する対話的なプログラムです。<Command>dtinfogen admin</Command> コマンドを実行するには、コマンド行で、次のように入力します。
<command>dtdocbook2infolib admin</command> は、実行する管理操作を選択できるメニューを表示する対話的なプログラムです。<Command>dtdocbook2infolib admin</Command> コマンドを実行するには、コマンド行で、次のように入力します。
</Para>
<ProgramListing>
<UserInput>dtinfogen admin</UserInput>
<UserInput>dtdocbook2infolib admin</UserInput>
</ProgramListing>
<Para>
リターン・キーを押すと、次のメニューが表示されます。
@ -64,10 +64,10 @@
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary><Secondary>〜間のブックケースのコピー</Secondary></IndexTerm>
<IndexTerm><Primary>ブックケース</Primary><Secondary>別のライブラリからのコピー</Secondary></IndexTerm>
<Para>
別のライブラリからブックケースをコピーする場合、<command>dtinfogen admin</command> は、コピー先のライブラリのブックケースに対してコピーしようとするブックケースを検証します。これにより、ライブラリ内のセクションIDの重複を避け、データベースのバージョンが互換であることを確実にします。
別のライブラリからブックケースをコピーする場合、<command>dtdocbook2infolib admin</command> は、コピー先のライブラリのブックケースに対してコピーしようとするブックケースを検証します。これにより、ライブラリ内のセクションIDの重複を避け、データベースのバージョンが互換であることを確実にします。
</Para>
<Para>
コピーしようとするブックケースがすでにコピー先のライブラリに存在すると、<Command>dtinfogen admin</Command> は、ブックケースを置換するかどうかを、ユーザに問い合わせます。
コピーしようとするブックケースがすでにコピー先のライブラリに存在すると、<Command>dtdocbook2infolib admin</Command> は、ブックケースを置換するかどうかを、ユーザに問い合わせます。
</Para>
<Para>
別のライブラリからブックケースをコピーするには、次のようにします。
@ -75,7 +75,7 @@
<OrderedList>
<ListItem>
<Para>
コマンド行で、<UserInput>dtinfogen admin</UserInput> を入力します。
コマンド行で、<UserInput>dtdocbook2infolib admin</UserInput> を入力します。
</Para>
<Para>
次のメニューが表示されます。
@ -95,7 +95,7 @@
コマンド行で、<UserInput>1</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
<command>dtdocbook2infolib admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
ブックケースをコピーしたいライブラリへのパスを入力してください。
@ -108,7 +108,7 @@
たとえば、<UserInput>/lit/wolfe</UserInput> のように入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、ユーザが指定したライブラリで有効なブックケースを表示します。例を以下に示します。
<command>dtdocbook2infolib admin</command> は、ユーザが指定したライブラリで有効なブックケースを表示します。例を以下に示します。
</Para>
<LiteralLayout>
/lit/wolfe で有効なブックケースは、次のとおりです。
@ -122,7 +122,7 @@
</ListItem>
<ListItem>
<Para>
プロンプトに続いて、コピーしたいブックケースに対応する番号を入力します。<command>dtinfogen admin</command> は、次のように表示してきます。
プロンプトに続いて、コピーしたいブックケースに対応する番号を入力します。<command>dtdocbook2infolib admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
<Replaceable>[Life]</Replaceable> が指定されました。
@ -139,7 +139,7 @@
ブックケースをコピーしたいインフォメーション・ライブラリへのパスを入力します。たとえば、<UserInput>/lit/destiny</UserInput> のように入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、ユーザが指定したライブラリで有効なブックケースを表示します。
<command>dtdocbook2infolib admin</command> は、ユーザが指定したライブラリで有効なブックケースを表示します。
</Para>
<LiteralLayout>
/lit/destiny で有効なブックケースは、次のとおりです。
@ -159,7 +159,7 @@
すでに別のブックケースが選択した位置を占有している場合、コピーしようとするブックケースはその位置を占め、元のブックケースはリストのひとつ下に移動します。
</Para>
<Para>
<command>dtinfogen admin</command> は、ライブラリのブックケースを更新された順序で表示します。例を次に示します。
<command>dtdocbook2infolib admin</command> は、ライブラリのブックケースを更新された順序で表示します。例を次に示します。
</Para>
<LiteralLayout>
更新後のブックケースの順番は、次のとおりです。
@ -173,7 +173,7 @@
</ListItem>
<ListItem>
<Para>
この位置にブックケースをコピーするには、<UserInput>Y</UserInput> を入力します。<command>dtinfogen admin</command> は、ライブラリへの追加を保存し、メイン・メニューに戻ります。
この位置にブックケースをコピーするには、<UserInput>Y</UserInput> を入力します。<command>dtdocbook2infolib admin</command> は、ライブラリへの追加を保存し、メイン・メニューに戻ります。
</Para>
</ListItem>
</OrderedList>
@ -186,10 +186,10 @@
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary><Secondary>〜のブックケースの削除</Secondary></IndexTerm>
<IndexTerm><Primary>ブックケース</Primary><Secondary>ライブラリの〜の削除</Secondary></IndexTerm>
<Para>
<command>dtinfogen admin</command> によるブックケースの削除の手続きは、ライブラリへのブックケースのコピーの手続きと似ています。ライブラリからブックケースを削除する場合、そのデータベースは、インフォメーション・ライブラリから削除されます。
<command>dtdocbook2infolib admin</command> によるブックケースの削除の手続きは、ライブラリへのブックケースのコピーの手続きと似ています。ライブラリからブックケースを削除する場合、そのデータベースは、インフォメーション・ライブラリから削除されます。
</Para>
<Para>
ライブラリを指定すると、<Command>dtinfogen admin</Command> は、そのライブラリでみつかったブックケースの一覧を表示します。ユーザは、削除したいブックケースを指定するだけです。指定した情報が無効な場合、<Command>dtinfogen admin</Command> は、指定したブックケースを削除する前に、確認を求めてきます。
ライブラリを指定すると、<Command>dtdocbook2infolib admin</Command> は、そのライブラリでみつかったブックケースの一覧を表示します。ユーザは、削除したいブックケースを指定するだけです。指定した情報が無効な場合、<Command>dtdocbook2infolib admin</Command> は、指定したブックケースを削除する前に、確認を求めてきます。
</Para>
<Para>
ライブラリからブックケースを削除するには、次のようにします。
@ -197,7 +197,7 @@
<OrderedList>
<ListItem>
<Para>
コマンド行で、<UserInput>dtinfogen admin</UserInput> を入力します。
コマンド行で、<UserInput>dtdocbook2infolib admin</UserInput> を入力します。
</Para>
<Para>
次のメニューが表示されます。
@ -217,7 +217,7 @@
ブックケースを削除するには、<UserInput>2</UserInput> を入力します。
</Para>
<Para>
<Command>dtinfogen admin</Command> は、次のように表示してきます。
<Command>dtdocbook2infolib admin</Command> は、次のように表示してきます。
</Para>
<LiteralLayout>
ブックケースを削除したいライブラリへのパスを入力してください。
@ -229,7 +229,7 @@
ブックケースを削除したいインフォメーション・ライブラリへのパスを入力します。たとえば、<UserInput>/lit/wolfe</UserInput> のように入力します。
</Para>
<Para>
<Command>dtinfogen admin</Command> は、指定されたライブラリで有効なブックケースを表示してきます。
<Command>dtdocbook2infolib admin</Command> は、指定されたライブラリで有効なブックケースを表示してきます。
</Para>
<LiteralLayout>
/lit/wolfe で有効なブックケースは、次のとおりです。
@ -244,7 +244,7 @@
<ListItem>
<Para>
プロンプトに続いて、削除したいブックケースに対応する番号を入力します。
<Command>dtinfogen admin</Command> は、次のように表示してきます。
<Command>dtdocbook2infolib admin</Command> は、次のように表示してきます。
</Para>
<LiteralLayout>
<Replaceable>[Essays]</Replaceable> が指定されました。
@ -253,7 +253,7 @@
</ListItem>
<ListItem>
<Para>
指定したブックケースを削除するには、<UserInput>Y</UserInput> を入力します。<Command>dtinfogen admin</Command> はブックケースを削除し、メイン・メニューに戻ります。
指定したブックケースを削除するには、<UserInput>Y</UserInput> を入力します。<Command>dtdocbook2infolib admin</Command> はブックケースを削除し、メイン・メニューに戻ります。
</Para>
</ListItem>
</OrderedList>
@ -272,10 +272,10 @@
<OrderedList>
<ListItem>
<Para>
コマンド行で、<UserInput>dtinfogen admin</UserInput> を入力します。
コマンド行で、<UserInput>dtdocbook2infolib admin</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
<command>dtdocbook2infolib admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
1) 別のライブラリからのブックケースのコピー
@ -292,7 +292,7 @@
ブックケースの一覧を表示するには、<UserInput>3</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
<command>dtdocbook2infolib admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
ブックケースの一覧を表示したいライブラリへのパスを入力してください。
@ -304,7 +304,7 @@
ブックケースの一覧を表示したいインフォメーション・ライブラリへのパスを入力します。たとえば、<UserInput>/lit/wolfe</UserInput> のように入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、指定されたライブラリで有効なブックケースを表示してきます。例を次に示します。
<command>dtdocbook2infolib admin</command> は、指定されたライブラリで有効なブックケースを表示してきます。例を次に示します。
</Para>
<LiteralLayout>
/lit.wolfe で有効なブックケースは、次のとおりです。
@ -316,7 +316,7 @@
</ListItem>
<ListItem>
<Para>
インフォメーション・ライブラリのブックケースの一覧を表示した後、<command>dtinfogen admin</command> は、メイン・メニューに戻ります。
インフォメーション・ライブラリのブックケースの一覧を表示した後、<command>dtdocbook2infolib admin</command> は、メイン・メニューに戻ります。
</Para>
</ListItem>
</OrderedList>
@ -333,10 +333,10 @@
<OrderedList>
<ListItem>
<Para>
コマンド行で、<UserInput>dtinfogen admin</UserInput> を入力します。
コマンド行で、<UserInput>dtdocbook2infolib admin</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
<command>dtdocbook2infolib admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
1) 別のライブラリからのブックケースのコピー
@ -353,7 +353,7 @@
ブックケースの名称を変更するには、<UserInput>4</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
<command>dtdocbook2infolib admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
名称を変更したいブックケースがあるライブラリへのパスを入力してください。
@ -365,7 +365,7 @@
名称を変更したいインフォメーション・ライブラリへのパスを入力します。たとえば、<UserInput>/lit/wolfe</UserInput> のように入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、指定されたライブラリで有効なブックケース
<command>dtdocbook2infolib admin</command> は、指定されたライブラリで有効なブックケース
を表示してきます。
</Para>
<LiteralLayout>
@ -380,7 +380,7 @@
</ListItem>
<ListItem>
<Para>
プロンプトに続いて、名称を変更したいブックケースに対応する番号を入力します。<command>dtinfogen admin</command> は、次のように表示してきます。
プロンプトに続いて、名称を変更したいブックケースに対応する番号を入力します。<command>dtdocbook2infolib admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
<Replaceable>[Poems]</Replaceable> が指定されました。
@ -389,7 +389,7 @@
</ListItem>
<ListItem>
<Para>
指定したブックケースの名称を変更するには、<UserInput>Y</UserInput> を入力します。<command>dtinfogen admin</command> は、ブックケースの新規タイトルを問い合わせてきます。
指定したブックケースの名称を変更するには、<UserInput>Y</UserInput> を入力します。<command>dtdocbook2infolib admin</command> は、ブックケースの新規タイトルを問い合わせてきます。
</Para>
<LiteralLayout>
<Replaceable>[Poems]</Replaceable> の新しい名前を入力してください。
@ -397,7 +397,7 @@
</ListItem>
<ListItem>
<Para>
ブックケースの新規タイトルを入力します。<command>dtinfogen admin</command> は、次のように新規タイトルを表示してきます。
ブックケースの新規タイトルを入力します。<command>dtdocbook2infolib admin</command> は、次のように新規タイトルを表示してきます。
</Para>
<LiteralLayout>
入力された名前は <Replaceable>[Old Poems]</Replaceable> です。
@ -406,7 +406,7 @@
</ListItem>
<ListItem>
<Para>
この新規タイトルでよければ、<UserInput>Y</UserInput> を入力します。<command>dtinfogen admin</command> は新規タイトルを保存し、メイン・メニューに戻ります。
この新規タイトルでよければ、<UserInput>Y</UserInput> を入力します。<command>dtdocbook2infolib admin</command> は新規タイトルを保存し、メイン・メニューに戻ります。
</Para>
</ListItem>
</OrderedList>
@ -417,7 +417,7 @@
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary><Secondary>〜のブックケースの再調整</Secondary></IndexTerm>
<IndexTerm><Primary>ブックケース</Primary><Secondary>ライブラリの〜の再調整</Secondary></IndexTerm>
<Para>
ライブラリ構築後に、インフォメーション・マネージャのブック・リストで、ブックケースを異なる順序で表示させたいときがあります。また、<Command>dtinfogen build</Command> を使用してブックケースを追加し、それを別の位置に移動させたいときがあります。<Command>dtinfogen admin</Command> を使用して、ライブラリのブックケースの順序を変更することができます。
ライブラリ構築後に、インフォメーション・マネージャのブック・リストで、ブックケースを異なる順序で表示させたいときがあります。また、<Command>dtdocbook2infolib build</Command> を使用してブックケースを追加し、それを別の位置に移動させたいときがあります。<Command>dtdocbook2infolib admin</Command> を使用して、ライブラリのブックケースの順序を変更することができます。
</Para>
<Para>
ライブラリ内のブックケースを再調整するには、次のようにします。
@ -425,10 +425,10 @@
<OrderedList>
<ListItem>
<Para>
コマンド行で、<UserInput>dtinfogen admin</UserInput> を入力します。
コマンド行で、<UserInput>dtdocbook2infolib admin</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
<command>dtdocbook2infolib admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
1) 別のライブラリからのブックケースのコピー
@ -445,7 +445,7 @@
ライブラリのブックケースを再調整するには、<UserInput>5</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
<command>dtdocbook2infolib admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
再調整したいライブラリへのパスを入力してください。
@ -457,7 +457,7 @@
再調整したいインフォメーション・ライブラリへのパスを入力します。たとえば、<UserInput>/lit/wolfe</UserInput> のように入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、指定されたライブラリで有効なブックケースを表示してきます。
<command>dtdocbook2infolib admin</command> は、指定されたライブラリで有効なブックケースを表示してきます。
</Para>
<LiteralLayout>
/lit/wolfe で有効なブックケースは、次のとおりです。
@ -471,7 +471,7 @@
</ListItem>
<ListItem>
<Para>
プロンプトに続いて、移動したいブックケースに対応する番号を入力します。<command>dtinfogen admin</command> は、次のように表示してきます。
プロンプトに続いて、移動したいブックケースに対応する番号を入力します。<command>dtdocbook2infolib admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
<Replaceable>[Poems]</Replaceable> が指定されました。
@ -480,7 +480,7 @@
</ListItem>
<ListItem>
<Para>
指定したブックケースをライブラリの別の位置に移動するには、<UserInput>Y</UserInput> を入力します。<command>dtinfogen admin</command> は、移動を選択したブックケースが含まれないライブラリの現在の順序を表示してきます。例を次に示します。
指定したブックケースをライブラリの別の位置に移動するには、<UserInput>Y</UserInput> を入力します。<command>dtdocbook2infolib admin</command> は、移動を選択したブックケースが含まれないライブラリの現在の順序を表示してきます。例を次に示します。
</Para>
<LiteralLayout>
[Poems] を含めない順序は、次のとおりです。
@ -500,7 +500,7 @@
選択した位置を別のブックケースがすでに占有していた場合には、移動したブックケースがその位置を占め、元のブックケースはリストのひとつ下の位置に移動します。
</Para>
<Para>
<Command>dtinfogen admin</Command> は、ライブラリの新しいブックケースの順序を表示してきます。例を次に示します。
<Command>dtdocbook2infolib admin</Command> は、ライブラリの新しいブックケースの順序を表示してきます。例を次に示します。
</Para>
<LiteralLayout>
指定されたブックケースの順番は次のとおりです。
@ -514,7 +514,7 @@
</ListItem>
<ListItem>
<Para>
再調整された順序でよければ、<UserInput>Y</UserInput> を入力します。<Command>dtinfogen admin</Command> は、新規の順序を保存し、メイン・メニューに戻ります。
再調整された順序でよければ、<UserInput>Y</UserInput> を入力します。<Command>dtdocbook2infolib admin</Command> は、新規の順序を保存し、メイン・メニューに戻ります。
</Para>
</ListItem>
</OrderedList>

30
cde/doc/ja_JP.UTF-8/guides/infoAPg/ch06.sgm
View file

@ -17,28 +17,28 @@
<ListItem>
<Para>
構築エラー: このエラーは、次の過程で発生します。
<Command>dtinfogen build</Command>
<Command>dtinfogen tocgen</Command>
<Command>dtinfogen update</Command>
<Command>dtdocbook2infolib build</Command>
<Command>dtdocbook2infolib tocgen</Command>
<Command>dtdocbook2infolib update</Command>
</Para>
</ListItem>
<ListItem>
<Para>
スタイル・シート・エラー: このエラーは、次の過程で発生します。
<Command>dtinfogen build</Command>
<Command>dtinfogen update</Command>
<Command>dtdocbook2infolib build</Command>
<Command>dtdocbook2infolib update</Command>
</Para>
</ListItem>
<ListItem>
<Para>
ライブラリ管理エラー: このエラーは、次の過程で発生します。
<Command>dtinfogen admin</Command>
<Command>dtdocbook2infolib admin</Command>
</Para>
</ListItem>
</ItemizedList>
<Para>
詳細については、<filename>dtinfogen(1)</filename> マニュアル・ページを参照してください。
詳細については、<filename>dtdocbook2infolib(1)</filename> マニュアル・ページを参照してください。
</Para>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
@ -47,9 +47,9 @@
<Title id="DW3SgFBd02698oL">構築エラー</Title>
<Para>
次に示すエラー・メッセージは、一般に構築過程に関連するものであり、次のプログラムのいずれかによって生成されます。
<Command>dtinfogen build</Command>
<Command>dtinfogen tocgen</Command>
<Command>dtinfogen update</Command>
<Command>dtdocbook2infolib build</Command>
<Command>dtdocbook2infolib tocgen</Command>
<Command>dtdocbook2infolib update</Command>
</Para>
<para>
次にエラー・メッセージとその意味を示します。
@ -356,7 +356,7 @@ object.
<Title id="L4E7gLBYimg24aK">ライブラリ管理メッセージ</Title>
<Para>
次に示すエラー・メッセージは、<Command>dtinfogen admin</Command> コマンドに関連するものです。
次に示すエラー・メッセージは、<Command>dtdocbook2infolib admin</Command> コマンドに関連するものです。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
@ -378,7 +378,7 @@ object.
</computeroutput>
</literallayout>
<para>
このエラーは、<Command>dtinfogen admin</Command> の検証処理の段階で問題がみつかり、ブックケースがコピー先のライブラリにコピーされなかったことを意味しています。問題は、バージョンの不一致または重複したIDによるものである可能性があります。
このエラーは、<Command>dtdocbook2infolib admin</Command> の検証処理の段階で問題がみつかり、ブックケースがコピー先のライブラリにコピーされなかったことを意味しています。問題は、バージョンの不一致または重複したIDによるものである可能性があります。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
@ -391,7 +391,7 @@ object.
</computeroutput>
</literallayout>
<para>
このエラーは、コピーしようとしているブックケース (<Replaceable>checkbase</Replaceable>) とインフォメーション・ライブラリ（インストールされたベース）に存在するブックケースに、<Command>dtinfogen admin</command> によって、バージョンの不一致がみつかったことを意味しています。同じバージョンの構築ツールで、ブックケースを再構築してください。
このエラーは、コピーしようとしているブックケース (<Replaceable>checkbase</Replaceable>) とインフォメーション・ライブラリ（インストールされたベース）に存在するブックケースに、<Command>dtdocbook2infolib admin</command> によって、バージョンの不一致がみつかったことを意味しています。同じバージョンの構築ツールで、ブックケースを再構築してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
@ -402,7 +402,7 @@ object.
</computeroutput>
</literallayout>
<para>
このエラーは、コピーしようとしているブックケースとコピー先のブックケース <Replaceable>BookCaseName</Replaceable> のID <Replaceable>ID</Replaceable> の重複が、<Command>dtinfogen admin</Command> によってみつかったことを意味しています。
このエラーは、コピーしようとしているブックケースとコピー先のブックケース <Replaceable>BookCaseName</Replaceable> のID <Replaceable>ID</Replaceable> の重複が、<Command>dtdocbook2infolib admin</Command> によってみつかったことを意味しています。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
@ -424,7 +424,7 @@ object.
</computeroutput>
</literallayout>
<para>
このエラーは、<Command>dtinfogen admin</Command> が、インフォメーション・ライブラリ <Replaceable>InfoLibPath</Replaceable> からブックケース <Replaceable>BookCaseName</Replaceable> を削除できなかったことを意味しています。当該ブックケース変更のための正当なアクセス権があることを確認してください。また、当該ブックケースがインフォメーション・ライブラリに存在しないか、ブックケースへのパスが無効である可能性もあります。
このエラーは、<Command>dtdocbook2infolib admin</Command> が、インフォメーション・ライブラリ <Replaceable>InfoLibPath</Replaceable> からブックケース <Replaceable>BookCaseName</Replaceable> を削除できなかったことを意味しています。当該ブックケース変更のための正当なアクセス権があることを確認してください。また、当該ブックケースがインフォメーション・ライブラリに存在しないか、ブックケースへのパスが無効である可能性もあります。
</Para>
<para>
次にエラー・メッセージとその意味を示します。

4
cde/doc/ja_JP.UTF-8/guides/infoAPg/ch10.sgm
View file

@ -87,7 +87,7 @@ SGML ドキュメントは、特定の文書型定義 (DTD) に準拠します
</para>
<note>
<para>
これらの設計様式は、ほとんどの <command>dtinfogen</command> のサブコマンドの使用前に、適用しなければなりません。
これらの設計様式は、ほとんどの <command>dtdocbook2infolib</command> のサブコマンドの使用前に、適用しなければなりません。
</para>
</note>
<!--)))))))))))))))))))))))))))))))))))))))))-->
@ -209,7 +209,7 @@ DTINFO.Graphic CDATA #FIXED
<term><systemitem>DTINFO.Section</systemitem></term>
<listitem>
<para>
<systemitem>DTINFO.Section</systemitem> 様式を、章のようなインフォメーションの一部分を分離するコンテナ要素に適用します。<systemitem>DTINFO.Section</systemitem> を使用して、インフォメーション・マネージャの表示ウィンドウに、インフォメーションの単位として、どの要素を表示するかを定義します。<command>dtinfogen</command> は、<systemitem>DTINFO.Section</systemitem> を使用して、階層構造を引き出すことができます。
<systemitem>DTINFO.Section</systemitem> 様式を、章のようなインフォメーションの一部分を分離するコンテナ要素に適用します。<systemitem>DTINFO.Section</systemitem> を使用して、インフォメーション・マネージャの表示ウィンドウに、インフォメーションの単位として、どの要素を表示するかを定義します。<command>dtdocbook2infolib</command> は、<systemitem>DTINFO.Section</systemitem> を使用して、階層構造を引き出すことができます。
</para>
<para>
エンティテ名: <systemitem>DTINFO.Section</systemitem>

2
cde/doc/ja_JP.UTF-8/guides/infoAPg/glossary.sgm
View file

@ -25,7 +25,7 @@ SGML は、インフォメーション・マネージャのドキュメントの
</glossdef>
</Glossentry>
<GlossEntry>
<GlossTerm>dtinfogen</GlossTerm>
<GlossTerm>dtdocbook2infolib</GlossTerm>
<glossdef>
<para>
オンライン・ドキュメントのコンパイルと表示のシステムです。

2
cde/doc/ja_JP.UTF-8/guides/infoAPg/preface.sgm
View file

@ -60,7 +60,7 @@ SGML に準拠した文書を作成して、インフォメーション・マネ
</listitem>
<listitem>
<para>
第４章「インフォメーション・ライブラリの構築」では、<command>dtinfogen</command> コマンドによるインフォメーション・ライブラリの構築と更新の過程について説明します。
第４章「インフォメーション・ライブラリの構築」では、<command>dtdocbook2infolib</command> コマンドによるインフォメーション・ライブラリの構築と更新の過程について説明します。
</para>
</listitem>
<listitem>