Author: raffa
Date: 2008-03-08 23:33:45 +0100 (Sat, 08 Mar 2008)
New Revision: 1055
Modified:
trunk/hvirtual/doc/ChangeLog
trunk/hvirtual/doc/README_en
trunk/hvirtual/doc/TRANSLATIONS
trunk/hvirtual/doc/cinelerra_cv_manual_en.texi
trunk/hvirtual/doc/texinfo.tex
Log:
Update the doc folder
Update the English Manual to Ed. 1.55
Update doc/texinfo.tex to the latest release (04.02.08)
Update doc/TRANSLATIONS and doc/README_EN
For details see the doc/ChangeLog file
Modified: trunk/hvirtual/doc/ChangeLog
===================================================================
--- trunk/hvirtual/doc/ChangeLog 2008-03-04 20:57:28 UTC (rev 1054)
+++ trunk/hvirtual/doc/ChangeLog 2008-03-08 22:33:45 UTC (rev 1055)
@@ -1,11 +1,166 @@
+2008-03-08 raffa <raffaella.traniello@???>
+
+ * 1.55.EN
+ Chapter 1: Introduction
+ - Updated edition number
+ - Fixed typo (FFMPEG)
+ - Fixed broken links
+
+ Chapter 2: Installation
+ - Added link to Fedora
+ - Fixed broken links
+ - Added Ubuntu Hardy packages
+
+ Chapter 5: Loading and saving files
+ - Note on backup.xml with two instances open
+
+ Chapter 14: Realtime effects
+ - Added title performance tip
+ - Fixed formatting
+
+ Chapter 16: Transitions
+ - Removed footnote, moved content to the glossary.
+ - Rewritten most of the content.
+
+2008-02-16 raffa <raffaella.traniello@???>
+
+ * 1.54.EN
+ Chapter 1: Introduction
+ - Updated edition number
+ - Added a quote form Miro's Wiki about Cinelerra
+ - Added Norval Watson among the contributors
+ - Added Tutorial by Akirad and Howto on transcoding (by cillian)
+ - Added FFMPEG compatibility Howto and miscellaneous links on Interlacing and DVD-Video
+
+ Chapter 5: Loading and saving files
+ - Modified script for resizing images (note by Helge Nert, ML)
+ - Added descriptions of Imagemagick resizing
+ - Added details to the MPEG1 audio section
+
+ Chapter 20: Rendering Files
+ - Changed ffmpeg bitrate from -b 430 to -b 430k (by norv)
+
+ Chapter 21: Tips
+ - Removed description of issues fixed by r1052 (by j6t)
+
+
+2008-02-09 raffa <raffaella.traniello@???>
+
+ Update doc/texinfo.tex to the latest release (04.02.08)
+
+
+2008-01-28 raffa <raffaella.traniello@???>
+
+ * 1.53.EN
+ Chapter 1: Introduction
+ - Updated edition number
+
+ Chapter 2: Installation
+ - Improved Ubuntu package description
+
+
+2008-01-06 raffa <raffaella.traniello@???>
+
+ * 1.52.EN
+ Chapter 1: Introduction
+ - Updated edition number
+ - Added Iñaki Larrañaga Murgoitio “Dooteo” as Basque translator.
+ - Added Paolo Rampino in the contributors' list
+ - Added a reference to doc/TRANSLATIONS for translators
+ - Pointed to doc/README_en for instructions for building the manual in other formats
+ - Pointed to SVN to get the manual sources.
+ - Added a tutorial and a miscellany link
+
+ Chapter 2: Installation
+ - Added ldconfig in the commands for compilation
+ - Fixed typo mmx32
+ - Added ArtistX live CD (by cillian)
+ - Added Musix live CD
+ - Added Ubuntu Gutsy repos by Paolo Rampino (by cillian and akirad)
+ - Added details about libfaac version for ubuntu 64 (by cillian)
+ - Added 2 Howtos for compilation in Ubuntu Gutsy
+ - Minor changes
+
+ Chapter 3: Configuration
+ - How to localize Cinelerra on distributions with only UTF-8 support (by Paolo Rampino)
+
+ Chapter 6: Program Window
+ - Added a note about sample zoom
+ - Added details about the label info dialog
+ - Added notes on patchbay attributes Mute track and Fader
+ - Reordered content (selection of multiple files)
+ - Added a list of editing operations
+ - Minor changes
+
+ Chapter 21: Tips
+ - Note about creating charset for localizing Cinelerra on distributions with only UTF-8 support (by Paolo Rampino)
+ - Added node 365 about creating DVD video from Lower Quality Footage (by aum)
+
+
+2008-01-06 raffa <raffaella.traniello@???>
+
+ * doc/TRANSLATIONS - Update
+ Added details to the translation process.
+ Set the Cinelerra CV community as reference for translators.
+
+ * README_EN Updated
+ Added details in the description of the building of the Manuals from texinfo to all the available formats.
+
+
+2007-11-04 raffa <raffaella.traniello@???>
+
+ * 1.51.EN
+
+ Chapter 1: Introduction
+ - Updated edition number
+ - Reordered and updated the list of contributors
+ - Deleted cogito from the list of application needed to fetch the manual sources
+ - Replaced out of date command for fetching manual sources with FIXME
+
+ Chapter 2: Installation
+ - Rescued forgotten changes about Gentoo installation made by Cillian on Dokuwiki
+ - Added Ubuntu Gutsy repos by Valentina Messeri
+
+ Chapter 5: Saving project files
+ - Added details to for fixing media linkage via GUI.
+
+ Chapter 6: Program Window
+ - Deleted contradictory informations about in/out points and highlighted areas.
+ - Added notes on setting in/out points on highlighted areas.
+
+ Chapter 8: Compositor window
+ - Added details about cropping and reordered content
+
+
+2007-10-07 raffa <raffaella.traniello@???>
+
+ * 1.50.EN
+
+ Updated edition number
+
+ Chapter 2: Installation
+ - Change mmx to mmx32 for 32 bit Pentiums (by karrak)
+ - Add Marillat repository and delete obsolete information (by cosmo)
+
+ Chapter 6: Program window
+ - Added description of the Label tab of the Resources window
+
+ Chapter 20: Rendering files
+ - Adding information on converting flv file to swf and more detail on using flv movie players (by cillian)
+ - Added subsubsection yuv4mpeg pipe through mpeg2enc (node 363) (by kurts-film)
+ - Added subsubsection yuv4mpeg pipe through ffmpeg (node 364) (by kurts-film)
+
+ Chapter 21: Tips
+ - Added notes on HDV (new dvgrab HDV support and valid XML in recent version of Cinelerra) (by Marcin Kostur)
+
+
2007-09-27 Raffaella Traniello
* 1.49.EN
Chapter 14 Realtime Effects
-
- Included changes from the following svn commits:
+ - Included changes from the following svn commits:
r1027: Updated Videoscope doc. Added 2 images (manual_images_intl). Patch by Craig Lawson.
r1028: Documentation for RGB-601 effect. Patch by Craig Lawson.
r1033: Update Threshold documentation. Patch by Craig Lawson.
Modified: trunk/hvirtual/doc/README_en
===================================================================
--- trunk/hvirtual/doc/README_en 2008-03-04 20:57:28 UTC (rev 1054)
+++ trunk/hvirtual/doc/README_en 2008-03-08 22:33:45 UTC (rev 1055)
@@ -8,15 +8,28 @@
Virtual Ltd. Alex Ferrer's TWiki contents was put in by Nicolas Maufrais, who
worked on the original cinelerra.texi file in order to generate nice manuals.
-To fetch the manual sources:
-cg-clone
git://scm.pipapo.org/cinelerra/nicolasm
+The manual sources are shipped with Cinelerra's source code. They are Texinfo
+files and can be easily converted to other formats.
-To make the manuals in PDF, HTML and TXT formats, just execute:
-./make_manuals.sh <language code>
-Example: ./make_manuals.sh en
+To make the manuals in PDF, HTML (single page) HTML (one page per chapter, in a
+folder) and TXT formats just execute the script make_manuals.sh followed by the
+language code.
+
+Example for converting the English manual:
+ $ cd hvirtual/doc
+ $ ./make_manuals.sh en
+
+To get a folder with one file per chapter in DokuWiki sintax, type:
+ $ cd hvirtual/doc
+ $ ./make_wiki.sh en
+
+Dependencies:
+To build the Manuals the following applications have to be installed on your computer:
+texinfo
+TeX (for Debian or Ubuntu: tetex-bin and tetex-base)
+texi2html
+html2wiki (HTML::WikiConverter, for Ubuntu: is called libhtml-wikiconverter-perl)
-Dependency: texinfo has to be installed on your computer.
-
The manual can also be converted to Docbook, but you need the CVS version of
texinfo to do so. The "stable" version of Texinfo cannot produce a correct
Docbook file. If you have the binary of the CVS version of makeinfo available
Modified: trunk/hvirtual/doc/TRANSLATIONS
===================================================================
--- trunk/hvirtual/doc/TRANSLATIONS 2008-03-04 20:57:28 UTC (rev 1054)
+++ trunk/hvirtual/doc/TRANSLATIONS 2008-03-08 22:33:45 UTC (rev 1055)
@@ -2,13 +2,16 @@
to be read by the maintainers of the Cinelerra CV manual in other languages
than English.
-- To start a new translation, contact the Cinelerra CV documentation
- maintainer: Nicolas MAUFRAIS - Email: e.conti@???
-- Fetch the latest manual edition using the procedure described in the manual,
- section "Introduction", subsection "About this manual".
+- To start a new translation, contact the Cinelerra Community.
+ IRC: channel #cinelerra on Freenode.
+ Mailing list: cinelerra@???
+- Make sure you have the the latest English manual edition.
- Translate the texinfo file cinelerra_cv_manual_en.texi, and rename it to
cinelerra_cv_manual_xx.texi, "xx" being the two-letter ISO-639 code of the
language you translate the manual to.
+- Make sure your translated file is saved with ISO-8859 as character encoding
+ standard (UTF-8 is not fully supported by Texinfo, yet). Choose the part of
+ ISO-8859 appropriate for your language (eg: English is part 1 -> ISO-8859-1).
- Copy the manual_images_en folder, and rename it to manual_images_xx
- Change the images location in cinelerra_cv_manual_xx.texi, in order to point
to the images contained in manual_images_xx
@@ -19,14 +22,13 @@
convert the text and save them in .png format, using a level 7 compression
(in Gimp). Please do not rename the images filenames.
- Test everything works fine by running make_manuals.sh <language code>
-- When you have finished, send everything to the Cinelerra CV documentation
- maintainer.
+- When you have finished, send everything to the Cinelerra CV community.
-The translated manual will then be put into the Cinelerra CV documentation
-repository and uploaded to the Cinelerra CV website.
+The translated manual will then be put into the Cinelerra CV repository and
+uploaded to the Cinelerra CV website.
While you translate the manual, chances are that a new edition of the English
-manual is released. To keep track of the changes in the git repository, you can
-use the gitk GUI. To easily find differences between each edition, we recommend
-you use meld.
+manual is released. To keep track of the changes see doc/ChangeLog file.
+To easily find differences between each edition, we recommend you use meld
+(
http://meld.sourceforge.net/)
Modified: trunk/hvirtual/doc/cinelerra_cv_manual_en.texi
===================================================================
--- trunk/hvirtual/doc/cinelerra_cv_manual_en.texi 2008-03-04 20:57:28 UTC (rev 1054)
+++ trunk/hvirtual/doc/cinelerra_cv_manual_en.texi 2008-03-08 22:33:45 UTC (rev 1055)
@@ -15,7 +15,7 @@
@documentencoding ISO-8859-1
@settitle Cinelerra CV Manual
@afourpaper
-@set EDITION 1.49.EN
+@set EDITION 1.55.EN
@set VERSION 2.1
@finalout
@@ -129,6 +129,12 @@
Consumers should consider other tools such as Avidemux (@uref{
http://www.avidemux.org/}),
Kino (@uref{
http://kinodv.org/}) or Kdenlive (@uref{
http://kdenlive.org/}).
+Quote from Miro's Wiki (@uref{
http://www.mitvwiki.org/Cinelerra}):@*
+"The key difference between Cinelerra and many of the commercial editors is that
+Cinelerra hides much less from the user, exposing much of the inner workings to
+direct interaction. This can be harder to use, but does make it tremendously powerful,
+and for some operations blistering fast."
+
@c cincvdoc_node_number_4
@node The two versions of Cinelerra
@section The two versions of Cinelerra
@@ -201,30 +207,42 @@
Wiki into a unified document.
Cinelerra-CV documentation maintainers:@*
-English: Nicolas @sc{Maufrais} (coordinator)@*
-French: Jean-Luc @sc{Coulon}
+English: Nicolas @sc{Maufrais} (coordinator), Raffaella @sc{Traniello}
+(apprentice sorcerer)@*
+Manual translators:
+French: Jean-Luc @sc{Coulon}@*
+Brazilian Portuguese: Flavio @sc{Soares} (maintainer), Willie @sc{Marcel}@*
+Spanish: Alberto @sc{Ramallo}, Gustavo I@~niguez @sc{Goya} (chapter 17 -
+Keyframes)@*
+Basque: I@~naki Larra@~naga @sc{Murgoitio} "Dooteo".
+
+
Other contributors: Alexandre @sc{Bourget}, Kevin @sc{Brosius}, Carlos @sc{Davila},
Cillian @sc{de Roiste}, Rafael @sc{Diniz}, Pierre @sc{Dumuid}, Mike @sc{Edwards},
-Martin @sc{Ellison}, Graham @sc{Evans}, Scott @sc{Frase}, Joe @sc{Friedrichsen},
-Gus Gus, Terje @sc{Hanssen}, Mikko @sc{Huhtala}, Ben @sc{Jorden}, Nathan @sc{Kidd},
-Marcin @sc{Kostur}, Joseph @sc{L.}, Valentina @sc{Messeri}, Sean @sc{Pappalardo},
-Herman @sc{Robak}, Dana @sc{Rogers}, Jim @sc{Scott}, Andraz @sc{Tori}, Raffaella
-@sc{Traniello}, Hermann @sc{Vosseler}
+Martin @sc{Ellison}, Graham @sc{Evans}, Alex @sc{Ferrer}, Scott @sc{Frase}, Joe
+@sc{Friedrichsen}, gour, Gus Gus, Terje @sc{Hanssen}, Mikko @sc{Huhtala}, Ben @sc{Jorden},
+Nathan @sc{Kidd}, Marcin @sc{Kostur}, Joseph @sc{L.}, David @sc{McNab}, Valentina @sc{Messeri},
+Sean @sc{Pappalardo}, Paolo @sc{Rampino}, Herman @sc{Robak}, Dana @sc{Rogers}, Jim @sc{Scott}, Andraz @sc{Tori},
+Raffaella @sc{Traniello}, Hermann @sc{Vosseler}, Norval @sc{Watson}.
Thanks to the GNU project team, and particularly to Karl @sc{Berry}, maintainer
of GNU Texinfo, for the precious help he gave us during the elaboration of this
manual.
-@itemize
-@item To fetch the manual sources, install cogito and git-core on your computer
-and run:@*
-@command{cg-clone
git://scm.pipapo.org/cinelerra/nicolasm}
-@item You can participate on editing this manual by making changes in the
+The sources of the manuals are Texinfo files. They are in the same SVN repository
+as Cinelerra's source code (hvirtual/doc folder). They can be converted in many
+formats. The doc/README_en file contains instructions for building the manual in
+PDF, HTML (single page) HTML (one page per chapter, in a folder), plain TXT, TXT
+in DokuWiki sintax (one file per chapter, in a folder), Docbook.
+
+You can participate on editing this manual by making changes in the
Cinelerra-CV wiki:@*
@uref{
http://cvs.cinelerra.org/docs/wiki/doku.php}
-@end itemize
+If you would like to translate this manual in your language, see the doc/TRANSLATIONS
+file and contact the Cinelerra CV Community.
+
@ifnotplaintext
@ifnothtml
@ifnotdocbook
@@ -281,6 +299,9 @@
@uref{
https://docs.indymedia.org/view/Sysadmin/Cinelerra}
@item @b{Tutorial Cinelerra}, in Portuguese, by Leo @sc{Germani}@*
@uref{
http://www.estudiolivre.org/tiki-index.php?page=Cinelerra}
+@item @b{Cinelerra is very easy}, Introduction to Cinelerra, for beginners, by
+Paolo @sc{Rampino} @*
+@uref{
http://project.akirad.net/node/12}
@end itemize
@c cincvdoc_node_number_358
@@ -303,6 +324,15 @@
I@~niguez @sc{Goya} - how to add effects to titles. With downloadable sample
projects.@*
@uref{
http://kutxa.homeunix.org/bloga/2007/08/13/crear-titulos-diferentes-con-cinelerra/#more-246}
+@item @b{SimAV's HOWTOs}, by Simeon @sc{Volkel} - How to create a picture in picture
+effect, How to create overlays, How to change theme.@*
+@uref{
http://g-raffa.eu/SimAV/}
+@item @b{Tips for Transcoding Cinelerra Compatible Video with FFmpeg,
+MEncoder}, by Alexander @sc{Grundner} @*
+@uref{
http://www.alexandergrundner.com/2007/07/19/tips-for-transcoding-cinelerra-compatible-video-with-ffmpeg-mencoder}
+@item @b{FFMPEG compatibility} - HOWTO produce videos that can be played in common
+proprietary multimedia players@*
+@uref{
http://ffmpeg.mplayerhq.hu/compat.html}
@end itemize
@c cincvdoc_node_number_10
@@ -312,6 +342,8 @@
Miscellaneous links:
@itemize @bullet
+@item @b{Interlacing}@*
+@uref{
http://neuron2.net/LVG/interlacing.html}
@item @b{What is Deinterlacing? Facts, solutions, examples}@*
@uref{
http://www.100fps.com}
@item @b{MPEG-2 FAQ}@*
@@ -322,9 +354,16 @@
@uref{
http://lipas.uwasa.fi/~f76998/video/conversion}
@item @b{Colour specification and image coding}@*
@uref{
http://www.poynton.com/notes/colour_and_gamma/ColorFAQ.html}
+@item @b{DVD Video} - about DVD structure @*
+@uref{
http://wlug.org.nz/DVDVideo}
+@item @b{Creating DVD videos on Linux and Unix} - an excellent high level overview of
+DVD authoring in general on Linux @*
+@uref{
http://womble.decadent.org.uk/talks/dvd-ukuug06/dvd-talk-ukuug06-paper.html}
@item @b{lprod - Libre Production} a French Wiki full of resources for Open
Source video editing, especially for Cinelerra HV (among them an Ubuntu package)@*
@uref{
http://fr.lprod.org/wiki/doku.php}
+@item @b{Cinelerra CV Glossary} for newbies@*
+@uref{
http://g-raffa.eu/Cinelerra/cin_glossary.html}
@end itemize
@c cincvdoc_node_number_7
@@ -525,8 +564,11 @@
can be used:@*
@command{make 2>&1 | tee logfile}
-@item Finally, install Cinelerra CV:@*
+@item Install Cinelerra CV:@*
@command{sudo make install}
+
+@item Finally run as root (for first time compilation only):@*
+@command{ldconfig}
@end enumerate
@b{Notes:}
@@ -537,11 +579,11 @@
CPUs.
@item @b{For x86 CPUs only}:@*
You probably want to enable MMX support. To do that, run @command{./configure}
-with the @option{--enable-mmx} option. If you do that, you may have to use the
+with the @option{--enable-mmx32} option. If you do that, you may have to use the
@option{--without-pic} option too, otherwise, compilation may fail.
@item @b{For Pentium-M:}@*
Here are some useful compiler flags:@*
-@command{./configure --prefix=/usr --enable-x86 --enable-mmx --enable-freetype2
+@command{./configure --prefix=/usr --enable-x86 --enable-mmx32 --enable-freetype2
--with-buildinfo=svn/recompile CFLAGS='-O3 -pipe -fomit-frame-pointer
-funroll-all-loops -falign-loops=2 -falign-jumps=2 -falign-functions=2
-ffast-math -march=pentium-m -mfpmath=sse,387 -mmmx -msse'}
@@ -640,10 +682,14 @@
@item @b{x-evian} - Debian based live CD for multimedia creations -
@uref{
http://x-evian.org}
@item @b{Mediainlinux} - Knoppix based - @uref{
http://www.mediainlinux.org/}
+@item @b{Musix} - Knoppix based live CD for audio production, graphic design and
+video editing - @uref{
http://musix.org.ar}
@item @b{pho} (garbure) - dedicated to video editing -
@uref{
http://garbure.org/pho/}
@item @b{Slo-Tech} - based on Debian and Morphix -
@uref{
http://linux.slo-tech.com}
+@item @b{ArtistX} - Debian based live CD, Gnome or KDE. For multimedia
+productions - @uref{
http://artistx.org}
@end itemize
@c cincvdoc_node_number_357
@@ -704,6 +750,17 @@
@command{@w{deb
http://giss.tv/~vale/debian64/ ./}}
@end itemize
+Christian @sc{Marillat} makes binary Debian packages, built from the unofficial SVN
+releases, for stable, testing and unstable.
+@itemize @bullet
+@item @b{Apt source for amd64, hppa, i386, ia64, powerpc (not optimized):}@*
+@command{@w{deb
http://www.debian-multimedia.org BRANCH main}}
+@end itemize
+
+@b{Note:} BRANCH = stable, testing or unstable@*
+@b{Note:} Install @b{debian-multimedia-keyring} to add in your keyring Marillat's
+gpg-key.
+
@b{Note:} If Cinelerra produces the following error:@*
@command{cinelerra: relocation error: /usr/lib/libavcodec.so.0.4.8: undefined symbol:
faacDecOpen}@*
@@ -733,7 +790,7 @@
@b{Extra Debian packages}
-These are devleopment packages which are "non-standard", and you'll almost certainly have to install them if
+These are development packages which are "non-standard", and you'll almost certainly have to install them if
you want to compile Cinelerra:
@itemize @bullet
@@ -766,13 +823,6 @@
line, which is Christian Marillat's repository:@*
@command{deb
http://www.debian-multimedia.org/ sid main}
-In order to use the mirror you need to add in your gpg keyring Marillat's
-gpg-key:@*
-@command{gpg --keyserver
hkp://wwwkeys.eu.pgp.net --recv-keys 1F41B907}@*
-@command{gpg --armor --export 1F41B907 | sudo apt-key add -}@*
-If you do not use sudo, do the following under root:@*
-@command{gpg --armor --export 1F41B907 | apt-key add -}
-
You will need to apt-get install the following packages:
@itemize @bullet
@@ -795,11 +845,90 @@
@subsection Ubuntu packages repositories
@cindex Ubuntu packages repositories
+@b{For Ubuntu 8.04 Hardy Heron:}
+
+@itemize @bullet
+
+@item for all x86 (full working on 32 and 64 bits), by Paolo @sc{Rampino}:
+@verbatim
+deb
http://repository.akirad.net akirad-hardy main
+@end verbatim
+
+Installation notes:@*
+- To add this repository in your sources list use the following terminal
+ command:@*
+@command{sudo wget
http://repository.akirad.net/dists/hardy.list -O
+/etc/apt/sources.list.d/akirad.list}@*
+-Installations from this repository need an authentication key. Add it by
+ typing the following command in your terminal:@*
Maximum line limit reached: 500!
_______________________________________________
Cinelerra-commits mailing list
Cinelerra-commits@???
https://init.linpro.no/mailman/skolelinux.no/listinfo/cinelerra-commits
(text/plain)