[CCing devel mailing list for others to review]
On Tue, Mar 24, 2009 at 07:39:17PM +1300, Alister Hood wrote:
> Hi again,
Hi,
>
> Not long ago I suggested the "general overview" section of the
> documentation should have something like this put in it:
Sorry, but your email somehow vanished from my inbox.
>
>
>
> > "Pdf Editor allows simple manipulation of objects within the PDF
>
> > structure, using a graphical and command-line interface and a
>
> > powerful scripting language. Changes to a document are added to it
>
> > as a new revision so that old revisions can be viewed or saved as a
> new file.
>
> > This means that if you delete something from a document it can still
>
> > be seen in the previous revision, and the file will not get smaller."
>
>
Thanks! I have updated the xml file (see the attached patch).
>
> The other thing that isn't clear from the documentation is how other
> software deals with these revisions. Can they be seen by any other
> program? It would be good if the documentation stated this.
This part is also included in the patch. Unfortunately I don't know
about any software which would enable document history browsing. What is
clear, though, all PDF viewers have to display the most recent revision.
>
> Thanks,
Thanks
>
> Alister
>
Best regards
--
Michal Hocko
Update general overview with more explicit information about revisions
Alister Hood has suggested (on pdfedit-support mailing list) that we should
be more explicit about revisions and increasing file size after
modifications (as a result) in general overview section because those things
are not very intuitive as well as the fact that all objects (even removed)
are still present in later revisions.
Index: pdfedit-patches/doc/user/general.xml
===================================================================
--- pdfedit-patches.orig/doc/user/general.xml 2009-03-24 08:43:36.000000000 +0100
+++ pdfedit-patches/doc/user/general.xml 2009-03-24 08:42:41.000000000 +0100
@@ -1,9 +1,22 @@
<part id="general_part">
<title>PDFEdit general overview</title>
+ <footnote id='note_increasing_size'>
<para>
- Pdf Editor is primary created for simple editation and manipulation with objects of documents in PDF format
- and storing them as new version of document.
- Editation and manipulation with objets is by graphical and by commandline interface too.
- For simple use command line is using script language, which is usefull in graphical interface too.
+ This means that if you delete something from a document it can still
+ be seen in the previous revision, and the file will not get smaller.
+ </para>
+ </footnote>
+ <para>
+ Pdf Editor allows simple manipulation of objects within the PDF
+ structure, using a graphical and command-line interface and a
+ powerful scripting language.
+ </para>
+ <para>
+ Changes to a document are added to it as a new revision so that
+ old revisions can be viewed or saved as a new file
+ <footnoteref linkend='note_increasing_size'/>. All PDF viewers
+ have to display the content of the most recent revision. Though
+ we don't know of any PDF viewer (except for PDFedit) which would
+ enable also revision browsing.
</para>
</part>
------------------------------------------------------------------------------
Apps built with the Adobe(R) Flex(R) framework and Flex Builder(TM) are
powering Web 2.0 with engaging, cross-platform capabilities. Quickly and
easily build your RIAs with Flex Builder, the Eclipse(TM)based development
software that enables intelligent coding and step-through debugging.
Download the free 60 day trial. http://p.sf.net/sfu/www-adobe-com
_______________________________________________
Pdfedit-support mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/pdfedit-support
