<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
	"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article>
  <articleinfo>
    <title>Passepartout Frequently Asked Questions</title>
    <releaseinfo>$Id: faq.xml,v 1.10 2004-12-02 21:41:52 foo Exp $</releaseinfo>
  </articleinfo>
  
  <section>
    <title>General</title>

    <section>
      <title>What does <quote>Passepartout</quote> mean?</title>
      <para>
	An early draft name for Passepartout was
	<quote>Framer</quote> since it deals with frames. (We like
	FrameMaker a lot, not that it has much in common with
	Passepartout.) This was a very dull name, so we changed it. A
	passepartout is a kind of cardboard frame you put around
	watercolour paintings.
      </para>
    </section>

    <section>
      <title>How do I pronounce <quote>Passepartout</quote>?</title>
      <para>
	Like <quote>pus par two</quote>. Use a rolled French R if you
	like. The important thing is not pronouncing it like
	<quote>trout</quote>.
      </para>
    </section>
      
    <section>
      <title>Are you guys French?</title>
      <para>Non. I mean no.</para>
    </section>

  </section>

  <section>
    <title>Installation</title>

    <section>
      <title>Is there a public repository?</title>
      <para>Yes there is. Run the following command to check out a
      fresh copy: <command>svn checkout http://svn.gnome.org/svn/passepartout/trunk
      passepartout</command></para>

      <para>Note that you will have to build your own
      <application>configure</application> script using
      <application>autogen.sh</application>; see
      <filename>DEVNOTES</filename> for details.
      </para>
    </section>

    <section>
      <title>I have a problem with libxml++</title> 
      <para>
	Passepartout 0.4 and later uses the stable libxml++ 1.0
	API. Versions prior to 0.4 will only be guaranteed to build
	with <emphasis>exactly</emphasis> the version or versions of
	libxml++ that are specified in the
	<filename>INSTALL</filename> file. No version have yet been
	built against the libxml++ 2.6 branch.
      </para>
    </section>

    <section>
      <title>Configure says libxml++ is unknown to pkg-config</title>
      <para>
	Pkg-config can't find libxml++, because it doesn't know
	where to look. Try adding the path to the file
	<filename>libxml++-1.0.pc</filename> to the environment variable
	<varname>PKG_CONFIG_PATH</varname>. If libxml++ is installed in
	<filename>/usr/local/</filename> then the path is
	<filename>/usr/local/lib/pkgconfig/</filename>.
      </para>
    </section>

  </section>

  <section>
    <title>Using Passepartout</title>

    <section>
      <title>How do I edit text in Passepartout?</title>
      <para>
	You don't. You write the text in <acronym>XML</acronym>
	format in your favourite text editor, then you import the text
	into Passepartout. Read the User's Guide for more detailed
	instructions.
      </para>
    </section>

    <section>
      <title>If I import text into Passepartout, does that mean I can't
      change it afterwards?</title>
      <para>
	Not at all. Text is only imported by reference. If you edit
	and save changes to the <acronym>XML</acronym> file,
	Passepartout will notice the change and update the display.
      </para>
    </section>

    <section>
      <title>Does Passepartout support colored text?</title>
      <para>
	Not yet. Is does support grayscale text though. The
	<sgmltag>&lt;font&gt;</sgmltag> and
	<sgmltag>&lt;para&gt;</sgmltag> elements accept the
	<sgmltag>gray</sgmltag> attribute which can be a number
	between 0.0 and 1.0.
      </para>
    </section>

    <section>
      <title>Can I print documents from the command line?</title>
      <para>
	Not now, but in the future, we hope to make it possible to run
	Passepartout from a script.
      </para>
    </section>

    <section>
      <title>Can I use xml2ps as a stand-alone typesetter?</title>
      <para>
	Yes. Regrettably, xml2ps is poorly documented. The command
	<userinput>xml2ps -p 400x600 -p 200x500 &lt; foo.xml &gt;
	foo.ps</userinput> prints the content of
	<filename>foo.xml</filename> on two pages (400 x 600 and 200 x
	500 points respectively) and saves the result in
	<filename>foo.ps</filename>. The file
	<filename>foo.xml</filename> must be in the xml2ps
	<acronym>DTD</acronym>. If you want to use another
	<acronym>DTD</acronym>, you will have to filter it through
	a stylesheet with xsltproc.
      </para>
      <para>
	xml2ps does not support images.
      </para>
    </section>

    <section>
      <title>Is there no TrueType support?</title>
      <para>
	Yes there is, as of version 0.6.
      </para>
    </section>

  </section>

</article>
