diff options
author | gregory guy <[email protected]> | 2020-06-13 16:55:00 +0200 |
---|---|---|
committer | gregory guy <[email protected]> | 2020-06-21 15:36:20 +0200 |
commit | 0b2288da16894d45e95caf5c0f1f5cba3f17c2dd (patch) | |
tree | 7dc6943b6af7edd7500456aaa813d79c8f09c88b /doc | |
parent | 88aa431c9d79bad942de04f4b28954b428079fd1 (diff) | |
download | codeine-0b2288da16894d45e95caf5c0f1f5cba3f17c2dd.tar.gz codeine-0b2288da16894d45e95caf5c0f1f5cba3f17c2dd.zip |
Conversion to the cmake building system.
Signed-off-by: gregory guy <[email protected]>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/CMakeLists.txt | 1 | ||||
-rw-r--r-- | doc/en/CMakeLists.txt | 1 | ||||
-rw-r--r-- | doc/en/index.docbook | 437 | ||||
-rw-r--r-- | doc/en/main.png | bin | 0 -> 12016 bytes | |||
-rw-r--r-- | doc/man/CMakeLists.txt | 5 | ||||
-rw-r--r-- | doc/man/codeine.1 | 94 |
6 files changed, 538 insertions, 0 deletions
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt new file mode 100644 index 0000000..6d0aa9f --- /dev/null +++ b/doc/CMakeLists.txt @@ -0,0 +1 @@ +tde_auto_add_subdirectories( ) diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt new file mode 100644 index 0000000..ba3ef3e --- /dev/null +++ b/doc/en/CMakeLists.txt @@ -0,0 +1 @@ +tde_create_handbook( DESTINATION ${PROJECT_NAME} ) diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..c056003 --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,437 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.0//EN" "dtd/kdex.dtd" [ + <!ENTITY kappname "&codeine;"> + <!ENTITY codeine "<application>Codeine</application>"> + + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE"><!-- change language only here --> +]> + + +<!-- The language must NOT be changed here. --> + +<book lang="&language;"> + +<!-- This header contains all of the meta-information for the document such +as Authors, publish date, the abstract, and Keywords --> + +<bookinfo> +<title>The &codeine; Handbook</title> + +<authorgroup> +<author> +<firstname>Mike</firstname> +<surname>Diehl</surname> +<affiliation> +<address><email>[email protected]</email></address> +</affiliation> +</author> +</authorgroup> + +<!-- TRANS:ROLES_OF_TRANSLATORS --> + +<copyright> +<year>2004</year> +<holder>Mike Diehl</holder> +</copyright> +<!-- Translators: put here the copyright notice of the translation --> +<!-- Put here the FDL notice. Read the explanation in fdl-notice.docbook + and in the FDL itself on how to use it. --> +<legalnotice>&FDLNotice;</legalnotice> + +<!-- Date and version information of the documentation +Don't forget to include this last date and this last revision number, we +need them for translation coordination ! +Please respect the format of the date (DD/MM/YYYY) and of the version +(V.MM.LL), it could be used by automation scripts. +Do NOT change these in the translation. --> + +<date>10/19/2004</date> +<releaseinfo>1</releaseinfo> + +<!-- Abstract about this handbook --> + +<abstract> +<para> +&codeine; is a simple media player for the TRINITY Desktop Environment. &codeine; is a front end to the xine multi-media player. +</para> +</abstract> + +<!-- This is a set of Keywords for indexing by search engines. +Please at least include KDE, the KDE package it is in, the name + of your application, and a few relevant keywords. --> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Codeine</keyword> +<keyword>xine</keyword> +<keyword>video</keyword> +<keyword>multi-media</keyword> +</keywordset> + +</bookinfo> + +<!-- The contents of the documentation begin here. Label +each chapter so with the id attribute. This is necessary for two reasons: it +allows you to easily reference the chapter from other chapters of your +document, and if there is no ID, the name of the generated HTML files will vary +from time to time making it hard to manage for maintainers and for the CVS +system. Any chapter labelled (OPTIONAL) may be left out at the author's +discretion. Other chapters should not be left out in order to maintain a +consistent documentation style across all KDE apps. --> + +<chapter id="introduction"> +<title>Introduction</title> + +<screenshot> +<screeninfo>&codeine; Screenshot</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="main.png" format="PNG"/></imageobject> +<textobject><phrase>Screenshot</phrase></textobject> +</mediaobject> +</screenshot> + + +<para> +&codeine; is a simple media player using the xine backend. &codeine; is a no frills media player that is especially usefull for short video clips where most other media players would just get in the way. +</para> + +</chapter> + + +<chapter id="configuring"> +<title>Configuring &codeine;</title> + +<para></para> + +</chapter> + + +<chapter id="using"> +<title>Using &codeine;</title> + +<sect1 id="starting"> +<title>Starting &codeine;</title> +<para>&codeine; can be started from the K-Menu, or from the command-line</para> + +<sect2 id="starting-from-the-menu"> +<title>From the K-Menu</title> + +<para> +Open the &kde; program menu by clicking on the <guiicon>big K</guiicon> icon on your panel. This will raise the <guimenu>program menu</guimenu>. Move your cursor up the menu to the <guimenu>Multimedia</guimenu> menu item. Choose <guimenuitem>&codeine;</guimenuitem>. +</para> + +</sect2> + + +<sect2 id="starting-from-the-command-line"> +<title>From the Command Line</title> + +<para> +You can start &codeine; by typing it's name on the command line. If you include a file name it will play the file. +</para> + +<informalexample> +<screen> +<prompt>%</prompt><userinput><command>codeine</command> <option><replaceable>movie.avi</replaceable></option></userinput> +</screen> +</informalexample> + +</sect2> +</sect1> + + +</chapter> + + + +<chapter id="commands"> +<title>Menu and Command Reference</title> + +<sect1 id="play_menu"> +<title>The Play Menu</title> +<variablelist> +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo><keycap>Ctrl</keycap><keycap>o</keycap></keycombo> +</shortcut> +<guimenu>Play</guimenu> +<guimenuitem>Play File..</guimenuitem> +</menuchoice></term> +<listitem><para><action>Opens a file dialog to choose a file to play.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Play</guimenu> +<guimenuitem>Play Audio-CD</guimenuitem> +</menuchoice></term> +<listitem><para><action>Plays an Audio-CD that is in your CD-Rom drive.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Play</guimenu> +<guimenuitem>Play DVD</guimenuitem> +</menuchoice></term> +<listitem><para><action>Plays a DVD that is in your DVD drive.</action></para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo><keycap>Ctrl</keycap><keycap>q</keycap></keycombo> +</shortcut> +<guimenu>Play</guimenu> +<guimenuitem>Quit</guimenuitem> +</menuchoice></term> +<listitem><para><action>Quits &codeine;.</action></para></listitem> +</varlistentry> + +</variablelist> +</sect1> + + +<sect1 id="settings_menu"> +<title>The Settings Menu</title> +<variablelist> + + +<varlistentry> +<term><menuchoice> +<guimenu>Settings</guimenu> +<guisubmenu>Toolbars</guisubmenu> +<guimenuitem>Show Main Toolbar</guimenuitem> +</menuchoice></term> +<listitem><para><action>Enables or disable the main application toolbar.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Settings</guimenu> +<guisubmenu>Toolbars</guisubmenu> +<guimenuitem>Show DVD Toolbar</guimenuitem> +</menuchoice></term> +<listitem><para><action>Enables or disable the DVD toolbar.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Configure Shortcuts...</guimenuitem> +</menuchoice></term> +<listitem><para><action>Allows you to configure the &codeine; shortcuts.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Configure Toolbars...</guimenuitem> +</menuchoice></term> +<listitem><para><action>Allows you to configure the &codeine; toolbar options.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Configure Video...</guimenuitem> +</menuchoice></term> +<listitem><para><action>Opens a dialog for configuring the video output settings. The settings include: contrast, brightness, saturation, and hue.</action></para></listitem> +</varlistentry> + +</variablelist> +</sect1> + +<sect1 id="help_menu"> +<title>The Help Menu</title> +<variablelist> + +<varlistentry> +<term><menuchoice> +<guimenu>Help</guimenu> +<guimenuitem>&codeine; Handbook</guimenuitem> +</menuchoice></term> +<listitem><para><action>Opens this help document.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo><keycap>Shift</keycap><keycap>F1</keycap></keycombo> +</shortcut> +<guimenu>Help</guimenu> +<guimenuitem>What's This?</guimenuitem> +</menuchoice></term> +<listitem><para><action>Activates the "What's This?" mouse cursor allowing you to click an object to get a "What's this?" tooltip.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Help</guimenu> +<guimenuitem>Report Bug...</guimenuitem> +</menuchoice></term> +<listitem><para><action>Starts the bug report tool dialog window.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Help</guimenu> +<guimenuitem>About &codeine;</guimenuitem> +</menuchoice></term> +<listitem><para><action>Starts the About &codeine; dialog window.</action></para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Help</guimenu> +<guimenuitem>About KDE</guimenuitem> +</menuchoice></term> +<listitem><para><action>Starts the About &kde; dialog window.</action></para></listitem> +</varlistentry> + +</variablelist> +</sect1> + + +</chapter> + +<!-- +<chapter id="faq"> +<title>Questions and Answers</title> + +(OPTIONAL but recommended) This chapter should include all of the silly +(and not-so-silly) newbie questions that fill up your mailbox. This chapter +should be reserved for BRIEF questions and answers! If one question uses more +than a page or so then it should probably be part of the +"Using this Application" chapter instead. You should use links to +cross-reference questions to the parts of your documentation that answer them. +This is also a great place to provide pointers to other FAQ's if your users +must do some complicated configuration on other programs in order for your +application work. + +&reporting.bugs; +&updating.documentation; + +<qandaset id="faqlist"> +<qandaentry> +<question> +<para>My Mouse doesn't work. How do I quit &filelight;?</para> +</question> +<answer> +<para>You silly goose! Check out the <link linkend="commands">Commands +Section</link> for the answer.</para> +</answer> +</qandaentry> +<qandaentry> +<question> +<para>Why can't I twiddle my documents?</para> +</question> +<answer> +<para>You can only twiddle your documents if you have the foobar.lib +installed.</para> +</answer> +</qandaentry> +</qandaset> +</chapter> +--> + + + +<chapter id="credits"> + +<!-- Include credits for the programmers, documentation writers, and +contributors here. The license for your software should then be included below +the credits with a reference to the appropriate license file included in the KDE +distribution. --> + +<title>Credits and License</title> + +<sect1 id="kapp"> +<title>&codeine;</title> +<para>Program copyright 2004 Max B. Howell <email>[email protected]</email></para> + +&underGPL; + +</sect1> +<sect1 id="Documentation"> + +<title>Documentation</title> + +<para> +Documentation copyright 2004 Mike Diehl <email>[email protected]</email> +</para> + +&underFDL; + +</sect1> + +</chapter> + +<chapter id="requirements"> +<title>Requirements</title> + +<para>&codeine; requires the installation of some software packages. The required packages are listed below.</para> + + +<itemizedlist> +<title>Required:</title> +<listitem><para>tdelibs <ulink url="https://mirror.git.trinitydesktop.org/gitea/TDE/tdelibs"></ulink></para></listitem> +<listitem><para>xine-lib <ulink url="https://sourceforge.net/projects/xine/"></ulink></para></listitem> +</itemizedlist> +<itemizedlist> +<title>Optional:</title> +<listitem><para>XTest Library</para></listitem> +<listitem><para>xcb-util-keysyms</para></listitem> +</itemizedlist> + +<note><para>If you obtain these dependencies via a packaging system, you must +also install the devel versions of these packages!</para></note> + +</chapter> + + +<appendix id="installation"> +<title>Installation</title> + +<sect1 id="getting-codeine"> +<title>How to obtain &codeine;</title> + +<para> +&codeine; is now part of the TDE project, it can be found at: +<ulink url="http://trinitydesktop.org/">http://trinitydesktop.org/</ulink>. +</para> +</sect1> + +<sect1 id="compilation"> +<title>Compilation and Installation</title> + +<para> +In order to compile and install &codeine; on your system, type the following in the base directory; distribution: +<screen width="40"> +<prompt>%</prompt> <userinput>mkdir -p build</userinput> +<prompt>%</prompt> <userinput>cd build</userinput> +<prompt>%</prompt> <userinput>cmake ../</userinput> +<prompt>%</prompt> <userinput>make</userinput> +<prompt>%</prompt> <userinput>make install</userinput> +</screen> +</para> + +<para>Since &codeine; uses cmake you should have not trouble compiling it. Default options for cmake build are available in the INSTALL file.</para> + +</sect1> + +</appendix> + +&documentation.index; +</book> +<!-- +Local Variables: +mode: sgml +sgml-minimize-attributes:nil +sgml-general-insert-case:lower +sgml-indent-step:0 +sgml-indent-data:nil +End: +--> diff --git a/doc/en/main.png b/doc/en/main.png Binary files differnew file mode 100644 index 0000000..a13586e --- /dev/null +++ b/doc/en/main.png diff --git a/doc/man/CMakeLists.txt b/doc/man/CMakeLists.txt new file mode 100644 index 0000000..8512250 --- /dev/null +++ b/doc/man/CMakeLists.txt @@ -0,0 +1,5 @@ +INSTALL( + FILES ${PROJECT_NAME}.1 + DESTINATION ${MAN_INSTALL_DIR}/man1 + COMPONENT doc +) diff --git a/doc/man/codeine.1 b/doc/man/codeine.1 new file mode 100644 index 0000000..dac7494 --- /dev/null +++ b/doc/man/codeine.1 @@ -0,0 +1,94 @@ +'\" -*- coding: us-ascii -*- +.if \n(.g .ds T< \\FC +.if \n(.g .ds T> \\F[\n[.fam]] +.de URL +\\$2 \(la\\$1\(ra\\$3 +.. +.if \n(.g .mso www.tmac +.TH codeine 1 2006-05-12 "" "" +.SH NAME +codeine \- video player for TDE, designed to be as simple as possible +.SH SYNOPSIS +'nh +.fi +.ad l +\fBcodeine\fR \kx +.if (\nx>(\n(.l/2)) .nr x (\n(.l/5) +'in \n(.iu+\nxu +[ +\fB\fIQt-options\fB\fR +] [ +\fB\fTDE-options\fB\fR +] [ +\fB\fIURL|file\fB\fR +] [ +--play-dvd +] +'in \n(.iu-\nxu +.ad b +'hy +.SH DESCRIPTION +Video player with a different philosophy: Simple, uncluttered interface +.PP +Features: +.TP 0.2i +\(bu +Plays DVDs, VCDs, all video formats supported by Xine +.TP 0.2i +\(bu +Bundled with a simple web-page KPart +.TP 0.2i +\(bu +Starts quickly +.SH OPTIONS +All TDE and TQt +programs accept a some common command-line options. codeine has no +application-specific options. +.PP +.TP +\*(T<\fB\-\-help\fR\*(T> +Show help about options +.TP +\*(T<\fB\-\-help\-qt\fR\*(T> +Show TQt specific options +.TP +\*(T<\fB\-\-help\-tde\fR\*(T> +Show TDE specific options +.TP +\*(T<\fB\-\-help\-all\fR\*(T> +Show all options +.TP +\*(T<\fB\-\-author\fR\*(T> +Show author information +.TP +\*(T<\fB\-v\fR\*(T>, \*(T<\fB\-\-version\fR\*(T> +Show version information +.TP +\*(T<\fB\-\-license\fR\*(T> +Show license information +.TP +\*(T<\fB\-\-\fR\*(T> +Indicates end of options +.TP +\*(T<\fBURL|file\fR\*(T> +URL to or filename of a video +.TP +\*(T<\fB\-\-play\-dvd\fR\*(T> +Play DVD Video +.SH AUTHOR +Codeine was written by Max Howell <\*(T<[email protected]\*(T>> +Homepage: +.URL "" https://mirror.git.trinitydesktop.org/gitea/TDE/codeine/ +.SH COPYRIGHT +This manual page was written by Achim Bohnet <\*(T<[email protected]\*(T>>, +based on work of Anthony Mercatante +<\*(T<[email protected]\*(T>>, for the +Debian system (but may be used by others). +Tom Albers <\*(T<[email protected]\*(T>> documented the play-dvd part. +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU General Public License, +Version 2 or any later version published by the Free Software Foundation. +.PP +On Debian systems, the complete text of the GNU General Public Version 2 +License can be found in +\*(T<\fI/usr/share/common\-licenses/GPL\-2\fR\*(T>. |