15317N/A<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
15317N/A<!--ArborText, Inc., 1988-1999, v.4002-->
15908N/A<!--ARC : LSARC 2008/701 dia - Diagram Editor-->
15317N/A<!ENTITY envr-tt "ENVIRONMENT VARIABLES">
15317N/A<!ENTITY cmd "dia">
15317N/A<!ENTITY % commonents SYSTEM "smancommon.ent">
15317N/A%commonents;
15317N/A<!ENTITY % booktitles SYSTEM "booktitles.ent">
15317N/A%booktitles;
15317N/A<!ENTITY suncopy "Copyright (c) 2003,2004,2006,2007 Sun Microsystems, Inc. All Rights Reserved.">
15317N/A]>
15317N/A<?Pub UDT _bookmark _target>
15317N/A<?Pub Inc>
15317N/A
15317N/A<refentry id="dia-1">
15317N/A
15317N/A<!-- %Z%%M% %I% %E% SMI; -->
15317N/A<refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>1</manvolnum>
15317N/A<refmiscinfo class="date">31 Oct 2008</refmiscinfo>
15317N/A<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
15317N/A<refmiscinfo class="software">&release;</refmiscinfo>
15317N/A<refmiscinfo class="arch">generic</refmiscinfo>
15317N/A<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
15317N/A</refmeta>
15317N/A
15317N/A<indexterm><primary>&cmd;</primary></indexterm>
15317N/A<indexterm><primary>a diagram drawing program</primary></indexterm>
15317N/A
15317N/A<refnamediv id="dia-1-name">
15317N/A<refname>&cmd;</refname>
15317N/A<refpurpose>a diagram drawing program</refpurpose>
15317N/A</refnamediv>
15317N/A
15317N/A<refsynopsisdiv id="dia-1-synp"><title>&synp-tt;</title>
15317N/A<cmdsynopsis><command>&cmd;</command>
15317N/A<arg choice ="opt"><option>-credits</option></arg>
15317N/A<arg choice ="opt"><option>-export=<replaceable>_file_</replaceable></option></arg>
15317N/A<arg choice ="opt"><option>-help</option></arg>
15317N/A<arg choice ="opt"><option>-nosplash</option></arg>
15317N/A<arg choice ="opt"><option>-size=<replaceable>WxH</replaceable></option></arg>
15317N/A<arg choice ="opt"><option>-filter=<replaceable>TYPE</replaceable></option></arg>
15317N/A<arg choice ="opt"><option>-version</option></arg>
15317N/A<arg choice ="opt"><option>-log-to-stderr</option></arg>
15317N/A<arg choice ="opt"><option>-show-layers</option></arg>
15317N/A<arg choice ="opt"><option>-verbose</option></arg>
15317N/A<arg choice ="opt"><option>-nonew</option></arg>
15317N/A<arg>file ...</arg>
15317N/A</cmdsynopsis>
15317N/A</refsynopsisdiv>
15317N/A
15317N/A<refsect1 id="dia-1-desc"><title>&desc-tt;</title>
15317N/A<para>Dia is a general purpose diagram editor. Dia has a number of basic tools,
15317N/Alike lines and boxes but can also dynamically load
15317N/A<replaceable>sheets</replaceable>. A sheet is a
15317N/Acollection of tools that are used in a certain type of diagram. Dia is easily
15317N/Aextensible through the use of user defined sheets.</para>
15317N/A
15317N/A<para>All diagram objects in Dia have <replaceable>handles</replaceable>.
15317N/AHandles are small boxes on an object which allow the object to be resized, or
15317N/Aconnected to. Lines can be connected to each other and other objects with these
15317N/Ahandles and in this way graph structures can be formed. When objects are moved or resized
15317N/Athe connections will follow the objects.</para>
15317N/A
15317N/A<para>Diagrams drawn in Dia can be exported to numerous formats which are
15317N/Adescribed in the EXPORT FORMATS section.</para>
15317N/A</refsect1>
15317N/A
15317N/A<refsect1 id="dia-1-opts">
15317N/A<title>&opts-tt;</title>
15317N/A<para>Dia accepts the following options:</para>
15317N/A
15317N/A<variablelist termlength="large">
15317N/A<varlistentry>
15317N/A<term><option>c</option>, <option>-credits</option></term>
15317N/A<listitem><para>Display credits and exit.</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A<varlistentry>
15317N/A<term><option>e</option>, <option>-export=<replaceable>_file_</replaceable></option></term>
15317N/A<listitem><para>Export loaded file to <replaceable>_file_</replaceable>.</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A<varlistentry>
15317N/A<term><option>h</option>, <option>-help</option></term>
15317N/A<listitem><para>Display a list of all command line options.</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A<varlistentry>
15317N/A<term><option>n</option>, <option>-nosplash</option></term>
15317N/A<listitem><para>Do not show the splash screen.</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A<varlistentry>
15317N/A<term><option>s</option>, <option>-size=<replaceable>WxH</replaceable></option></term>
15317N/A<listitem><para>Export loaded file in decimal given width and/or height. You may only specify width or height. E.g. --size=<replaceable>520x</replaceable> exports an image that is 520 pixels wide, while --size=<replaceable>x900</replaceable> exports an image of 900 pixels in height.</para>
15317N/A<para>Note this option is currently only implemented for the PNG export filter.</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A<varlistentry>
15317N/A<term><option>t</option>, <option>-filter=<replaceable>TYPE</replaceable></option></term>
15317N/A<listitem><para>Export loaded file in format TYPE and exit. Formats are described below.</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A<varlistentry>
15317N/A<term><option>v</option>, <option>-version</option></term>
15317N/A<listitem><para>Display Dia version and exit.</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A<varlistentry>
15317N/A<term><option>l</option>, <option>-log-to-stderr</option></term>
15317N/A<listitem><para>Send error messages to stderr instead of showing dialogs.</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A<varlistentry>
15317N/A<term><option>L</option>, <option>-show-layer=<replaceable>LAYER,LAYER,...</replaceable></option></term>
15317N/A<listitem><para>Show only specified layers (e.g. when exporting). Can be either the layer name or a range of layer numbers (X-Y).</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A<varlistentry>
15317N/A<term><option>-verbose</option></term>
15317N/A<listitem><para>Generate verbose output.</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A<varlistentry>
15317N/A<term><option>-nonew</option></term>
15317N/A<listitem><para>Do not create an empty diagram.</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A</variablelist>
15317N/A</refsect1>
15317N/A
15317N/A<!-- Export Formats -->
15317N/A<refsect1 id="dia-1-exam">
15317N/A<title>EXPORT FORMATS</title>
15317N/A<para>The following export formats are suppored by Dia: </para>
15317N/A<itemizedlist>
15317N/A<listitem>cgm (Computer Graphics Metafile, ISO 8632)</listitem>
15317N/A<listitem>dia (Native dia diagram)</listitem>
15317N/A<listitem>dxf (Drawing Interchange File)</listitem>
15317N/A<listitem>eps or epsi or eps-builtin or eps-pango (Encapsulated Postscript)<para>The format specifications eps, epsi, and eps-pango all use the font renderer of the Pango library, while eps-builtin uses a dia specific font renderer. If you have problems with Pango rendering, e.g. Unicode, try eps-builtin instead.</para></listitem>
15317N/A<listitem>fig (XFig format)</listitem>
15317N/A<listitem>mp (TeX MetaPost macros)</listitem>
15317N/A<listitem>plt or hpgl (HP Graphics Language)</listitem>
15317N/A<listitem>png (Portable Network Graphics)</listitem>
15317N/A<listitem>shape (Dia shape file)</listitem>
15317N/A<listitem>svg (Scalable Vector Graphics)</listitem>
15317N/A<listitem>tex (TeX PSTricks macros)</listitem>
15317N/A<listitem>wpg (WordPerfect Graphics)</listitem>
15317N/A<listitem>wmf (Windows Metafile)</listitem>
15317N/A</itemizedlist>
15317N/A</refsect1>
15317N/A
15317N/A<!-- Examples -->
15317N/A<refsect1 id="dia-1-exam"><title>&exam-tt;</title>
15317N/A<example role="example"><title>Launching dia</title>
15317N/A<para><screen>example% <userinput>&cmd;</userinput></screen></para>
15317N/A</example>
15317N/A<example role="example"><title>Exporting dia file to cgm format</title>
15317N/A<para><screen>example% <userinput>&cmd; --export=dia-test.sgm --filter=cgm dia-test.dia</userinput></screen></para>
15317N/A</example>
15317N/A</refsect1>
15317N/A
15317N/A<!-- Exit values -->
15317N/A<refsect1 id="dia-1-exit">
15317N/A<title>&exit-tt;</title>
15317N/A<para>The following exit values are returned:</para>
15317N/A<variablelist termlength="xtranarrow">
15317N/A<varlistentry>
15317N/A<term><returnvalue>&ndash;1</returnvalue></term>
15317N/A<listitem><para> Error</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A<varlistentry>
15317N/A<term><returnvalue>0</returnvalue></term>
15317N/A<listitem><para>OK</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A</variablelist>
15317N/A</refsect1>
15317N/A
15317N/A
15317N/A<!-- Files -->
15317N/A<refsect1 id="dia-1-file">
15317N/A<title>&file-tt;</title>
15317N/A<para>The following files are used by this application:</para>
15317N/A<variablelist termlength="medium">
15317N/A
15317N/A<varlistentry>
15317N/A<term><filename>/usr/bin/&cmd;</filename></term>
15317N/A<listitem> <para>Executable for Dia.</para></listitem>
15317N/A</varlistentry>
15317N/A
15317N/A</variablelist>
15317N/A</refsect1>
15317N/A
15317N/A
15317N/A<!-- Attributes -->
15317N/A<refsect1 id="dia-1-attr">
15317N/A<title>&attr-tt;</title>
15317N/A<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
15317N/A<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
15317N/Afor descriptions of the following attributes:</para>
15317N/A
15317N/A<informaltable frame="all">
15317N/A<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
15317N/A<colspec colname="COLSPEC1" colwidth="1*">
15317N/A<thead>
15317N/A<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
15317N/Avalign="middle">ATTRIBUTE VALUE</entry></row>
15317N/A</thead>
15317N/A<tbody>
18745N/A<row><entry><para>Availability</para></entry><entry><para>editor/diagram/dia</para></entry>
15317N/A</row>
15317N/A<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
15317N/Acolname="COLSPEC1"><para>Volitile</para></entry></row>
15317N/A</tbody>
15317N/A</tgroup>
15317N/A</informaltable>
15317N/A
15317N/A</refsect1>
15317N/A
15317N/A
15317N/A<!-- See also -->
15317N/A<refsect1 id="dia-1-also"><title>&also-tt;</title>
15317N/A<!--Reference to another man page-->
15317N/A<!--Reference to a Help manual-->
15317N/A<!--Reference to a book.-->
15317N/A<para><citetitle>Dia Manual</citetitle></para>
15317N/A<para>
15317N/A<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
15317N/A<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>
15317N/A</para>
15317N/A</refsect1>
15317N/A
15317N/A<refsect1 id="dia-1-note"><title>&note-tt;</title>
15317N/A<para>Written by Frederik Hallenberg, W. Borgert, Matt Keenan, Sun Microsystems Inc., 2008.</para>
15317N/A</refsect1>
15317N/A
15317N/A<refsect1 id="dia-1-copyright"><title>&copyright-tt;</title>
15317N/A<para>Copyright 1991 Alexander Larsson.</para>
15317N/A</refsect1>
15317N/A
15317N/A
15317N/A</refentry>