/video-contact-sheet/branches/1.13/dist/vcs.man.xml |
---|
525,11 → 525,10 |
alphabets (Chinese, Japanese, Hangul, Cyrillic, ...).</para> |
<para>When no font name is given, a reasonable choice will be made if possible.</para> |
<para>When <replaceable>FONTNAME</replaceable> is given, it can be either |
a font name: |
<programlisting>$ <command>vcs -Ij=Sazanami-Mincho-Regular <filename>file.avi</filename></command></programlisting> |
Or a font file name: |
<programlisting>$ <command>vcs -Ij=<filename>/usr/share/fonts/ttf/ttf-japanese-mincho.ttf</filename> <filename>file.avi</filename></command></programlisting> |
</para> |
a font name:</para> |
<para><literal>$ <command>vcs -Ij=Sazanami-Mincho-Regular <filename>file.avi</filename></command></literal></para> |
<para>Or a font file name:</para> |
<para><literal>$ <command>vcs -Ij=<filename>/usr/share/fonts/ttf/ttf-japanese-mincho.ttf</filename> <filename>file.avi</filename></command></literal></para> |
<para>A list of available fonts and their names can be obtained with the command |
<command>identify <option>-list font</option></command></para> |
</listitem> |
542,11 → 541,10 |
as if it was set from a configuration file.</para> |
<para>Some settings can only be changed through configuration files or overrides, while |
others have associated command-line options.</para> |
<para><replaceable>VALUE</replaceable> can be quoted to include spaces: |
<programlisting>$ <command>vcs -O SOME_SETTING="my value" <replaceable>...</replaceable></command></programlisting></para> |
<para><replaceable>VALUE</replaceable> can also refer to some other setting: |
<programlisting>$ <command>vcs -O SOME_SETTING='$SOME_OTHER_SETTING' <replaceable>...</replaceable></command></programlisting> |
</para> |
<para><replaceable>VALUE</replaceable> can be quoted to include spaces:</para> |
<para><literal>$ <command>vcs -O SOME_SETTING="my value" <replaceable>...</replaceable></command></literal></para> |
<para><replaceable>VALUE</replaceable> can also refer to some other setting:</para> |
<para><literal>$ <command>vcs -O SOME_SETTING='$SOME_OTHER_SETTING' <replaceable>...</replaceable></command></literal></para> |
<para>See <citerefentry><refentrytitle>vcs.conf</refentrytitle> <manvolnum>5</manvolnum></citerefentry> |
and the |
<ulink url="http://p.outlyer.net/dox/vcs">online documentation</ulink> for |
/video-contact-sheet/branches/1.13/dist/vcs.conf.man.xml |
---|
2,7 → 2,7 |
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" |
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ |
<!-- |
$Id: vcs.conf.man.xml 2297 2011-08-23 00:41:30Z toni $ |
$Id: vcs.conf.man.xml 2302 2011-08-24 03:05:03Z toni $ |
See vcs.man.xml for comments on docbook+man handling. |
--> |
<!ENTITY firstname "Toni"> |
12,8 → 12,32 |
<!ENTITY title "vcs.conf User Manual"> |
<!ENTITY package "vcs.conf"> |
<!ENTITY section "5"> |
<!ENTITY emdash "—"> |
]> |
<!-- |
XInclude trickery |
This voodoo is only required for the file to validate, it can be used |
by e.g. xsltproc without all of this |
Reference: http://www.sagehill.net/docbookxsl/ValidXinclude.html#XincludeDTD |
--> |
<!-- Define the xi:include and xi:fallback elements --> |
<!ELEMENT xi:include (xi:fallback?) > |
<!ATTLIST xi:include |
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude" |
href CDATA #IMPLIED |
parse (xml|text) "xml" |
xpointer CDATA #IMPLIED |
encoding CDATA #IMPLIED |
accept CDATA #IMPLIED |
accept-language CDATA #IMPLIED > |
<!ELEMENT xi:fallback ANY> |
<!ATTLIST xi:fallback |
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude" > |
<!-- Add xi:include to the list of possible children of refsect1 --> |
<!ENTITY % local.refcomponent.mix "| xi:include"> |
]><!--/!DOCTYPE--> |
<refentry> |
<refentryinfo> |
<title>&title;</title> |
34,7 → 58,7 |
Version 2 or (at your option) any later version published by |
the Free Software Foundation.</para> |
</legalnotice> |
<edition>$Rev: 2297 $</edition> |
<edition>$Rev: 2302 $</edition> |
</refentryinfo> |
<refmeta> |
<refentrytitle>&package;</refentrytitle> |
70,21 → 94,21 |
<replaceable>SETTING</replaceable>=<replaceable>VALUE</replaceable> |
assignments. |
</para> |
<para>Comments can be included by preceding `#' to them.</para> |
<para>Comments can be included by preceding `<literal>#</literal>' to them.</para> |
<refsect2 id="metainfo"> |
<title>META-INFORMATION</title> |
<para>Meta-information fields can be contained in comments. |
They are written as 'vcs:<replaceable>FIELD</replaceable>:'.</para> |
They are written as '<literal>vcs:<replaceable>FIELDNAME</replaceable>:</literal>'.</para> |
<para>Currently supported meta-information fields:</para> |
<variablelist> |
<varlistentry> |
<term>vcs:conf:</term> |
<term><literal>vcs:conf:</literal></term> |
<listitem><para>Marks a file as following this format.</para> |
<para>Files without this field will be rejected.</para> |
</listitem> |
</varlistentry> |
<varlistentry> |
<term>vcs:desc: <replaceable>DESCRIPTION</replaceable></term> |
<term><literal>vcs:desc:</literal> <replaceable>DESCRIPTION</replaceable></term> |
<listitem><para>Describes this particular file's purporse, |
it is shown e.g. when listing available profiles. |
</para> |
125,14 → 149,17 |
</itemizedlist> |
<para>Only the first profile for each name will be considered. |
Profiles with the same name will be hidden.</para> |
<para><programlisting>$ <command>vcs --profile :list</command></programlisting> |
can be used to get a list of available profiles.</para> |
<para>Profiles can only be loaded from the <link linkend="profile-paths">paths |
above</link>.</para> |
<para><literal>$ <command>vcs --profile :list</command></literal></para> |
<para>can be used to get a list of available profiles.</para> |
<para>Profiles can only be loaded from the <link linkend="profile-paths">listed |
paths</link>.</para> |
</refsect1><!--/PROFILE FILES--> |
<refsect1 id="settings"> |
<title>SETTINGS</title> |
<para>TO BE ADDED</para> |
<xi:include |
xmlns:xi="http://www.w3.org/2001/XInclude" |
href="mansrc/settings.man.inc.xml" /> |
</refsect1><!--/SETTINGS--> |
</refentry> |
<!-- vim:set ts=4 et: --> |
/video-contact-sheet/branches/1.13/Makefile |
---|
9,23 → 9,32 |
$(addprefix vcs.conf.man,.html .xhtml) \ |
) |
# Common part of command to convert docbook to man |
DOCBOOK_TO_MAN=xsltproc -o $(srcdir)/ -''-nonet \ |
-''-param man.charmap.use.subset "0" \ |
-''-param make.year.ranges "1" \ |
-''-param make.single.year.ranges "1" \ |
DOCBOOK_TO_MAN=xsltproc -o $(srcdir)/ -nonet \ |
--xinclude \ |
-param man.charmap.use.subset "0" \ |
-param make.year.ranges "1" \ |
-param make.single.year.ranges "1" \ |
/usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl |
all: $(ALL) |
@echo "Use $(MAKE) dist" |
@echo "Use $(MAKE) dist to create the actual distribution files" |
# man2html produces output closer to man and better formatted but |
# easily broken while xsltproc produces cleaner, more robust, and |
# cross-referenced output |
$(srcdir)/vcs.%.xhtml: $(srcdir)/vcs.%.xml |
xsltproc \ |
xsltproc -nonet \ |
--xinclude \ |
-param man.charmap.use.subset "0" \ |
-param make.year.ranges "1" \ |
-param make.single.year.ranges "1" \ |
/usr/share/xml/docbook/stylesheet/docbook-xsl/xhtml/docbook.xsl \ |
"$<" > "$@" |
# Check all XML files for validity |
xmllint: |
find . -type f -name '*.xml' -print0 | xargs -0 xmllint --xinclude -noout --valid |
$(srcdir)/vcs.man.html: $(srcdir)/vcs.1 |
man2html -r "$<" > "$@" |
70,6 → 79,10 |
CHANGELOG.gz CHANGELOG \ |
rpm deb |
# This shouldn't be re-built |
dist/mansrc/settings.man.inc.xml: |
cd dist/mansrc && $(MAKE) |
PKGBUILD-$(VER): vcs-$(VER).tar.gz |
cd pkg && ln -s ../vcs-$(VER).tar.gz ./ |
cd pkg && make PKGBUILD |