Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

svn::simple::edit(3) [osx man page]

SVN::Simple::Edit(3)					User Contributed Perl Documentation				      SVN::Simple::Edit(3)

SVN::Simple::Edit - A simple interface for driving svn delta editors SYNOPSIS
my $edit = SVN::Simple::Edit->new (_editor => [SVN::Repos::get_commit_editor($repos, "file://$repospath", '/', 'root', 'FOO', &committed)], ); $edit->open_root($fs->youngest_rev); $edit->add_directory ('trunk'); $edit->add_file ('trunk/filea'); $edit->modify_file ("trunk/fileb", "content", $checksum); $edit->delete_entry ("trunk/filec"); $edit->close_edit (); ... $edit->copy_directory ('branches/a, trunk, 0); DESCRIPTION
SVN::Simple::Edit wraps the subversion delta editor with a perl friendly interface and then you could easily drive it for describing changes to a tree. A common usage is to wrap the commit editor, so you could make commits to a subversion repository easily. This also means you can not supply the $edit object as an delta_editor to other API, and that's why this module is named ::Edit instead of ::Editor. See SVN::Simple::Editor for simple interface implementing a delta editor. PARAMETERS
for constructor _editor The editor that will receive delta editor calls. missing_handler Called when parent directory are not opened yet, could be: &SVN::Simple::Edit::build_missing Always build parents if you don't open them explicitly. &SVN::Simple::Edit::open_missing Always open the parents if you don't create them explicitly. SVN::Simple::Edit::check_missing ([$root]) Check if the path exists on $root. Open it if so, otherwise create it. root The default root to use by SVN::Simple::Edit::check_missing. base_path The base path the edit object is created to send delta editor calls. noclose Do not close files or directories. This might make non-sorted operations on directories/files work. METHODS
Note: Don't expect all editors will work with operations not sorted in DFS order. open_root ($base_rev) add_directory ($path) open_directory ($path) copy_directory ($path, $from, $fromrev) add_file ($path) open_file ($path) copy_file ($path, $from, $fromrev) delete_entry ($path) change_dir_prop ($path, $propname, $propvalue) change_file_prop ($path, $propname, $propvalue) close_edit () AUTHORS
Chia-liang Kao <> COPYRIGHT
Copyright 2003-2004 by Chia-liang Kao <>. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See <> perl v5.10.0 2005-02-23 SVN::Simple::Edit(3)

Check Out this Related Man Page

SVN::Web::X(3pm)					User Contributed Perl Documentation					  SVN::Web::X(3pm)

SVN::Web::X - exceptions for SVN::Web SYNOPSIS
use SVN::Web::X; ... SVN::Web::X->throw(error => '(error message %1)', vars => [$var_to_interpolate]); DESCRIPTION
SVN::Web::X implements exceptions for SVN::Web. Derived from Exception::Class, It provides a simple mechanism for throwing exceptions, catching them, and ensuring that friendly, localised error messages are generated and sent to the user's browser. USAGE IN SVN
::Web ACTIONS If an SVN::Web action that you are writing needs to stop processing and raise an error, throw an SVN::Web::X exception. "throw()" takes a hash with two mandatory keys. "error" A string describing the error. This string should be short, and key to a longer internationalised message. This string may contain placeholders; %1, %2, %3, and so on. These will be replaced by the values of the variables passed in the "vars" key. By convention this string should be enclosed in parentheses, "(" and ")". This helps make them stand out in the interface, if localised versions of the error message have not yet been written. "vars" An array reference. The first entry in the array will replace the %1 placeholder in "error", the second entry will replace the %2 placeholder, and so on. If there are no placeholders then pass a reference to an empty array. EXAMPLES
A simple exception, with no placeholders. In the action: sub run { ... if(! frob_repo()) { SVN::Web::X->throw(error => '(frob failed)', vars => []); } ... } In the en.po file for the localised text. msgid "(frob failed)" msgstr "There was a problem trying to frob the repository. This " "probably indicates a permissions problem." An exception with placeholders In the action: sub run { ... # $path is a repo path, $rev is a repo revision my $root = $fs->revision_root($rev); my $kind = $root->check_path($path); if($kind == $SVN::Node::none) { SVN::Web::X->throw(error => '(path %1 does not exist in rev %2)', vars => [$path, $rev]); } } In the en.po file for the localised text. msgid "(path %1 does not exist in rev %2)" msgstr "The path <tt>%1</tt> could not be found in the repository " "at revision %2. This may be a typo in the path or the revision " "number. SVN::Web should never normally generate a link like this. " "If you followed a link from SVN::Web (rather than from an e-mail, "or similar) please report this as a bug." As you can see, the localised text can be much friendlier and more informative to the user than the error message. COPYRIGHT
Copyright 2003-2004 by Chia-liang Kao "<>". Copyright 2005-2007 by Nik Clayton "<>". This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See <> perl v5.14.2 2012-06-11 SVN::Web::X(3pm)
Man Page