SVN_LOAD_DIRS(1)

📦 version 1.14.5, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

hey bestie, this is the SVN_LOAD_DIRS(1) page from the General Commands Manual 💖 ok so—

💖 NAME 💖

svn_load_dirs — Load directories into a Subversion repository, bestie. That's the whole name section, short and slay. ✨

🦋 SYNOPSIS 🦋

svn_load_dirs [options] svn_url svn_import_dir [directory ...]

🌸 DESCRIPTION 🌸

okay so this tool can be used for importing one or more directories into a Subversion repository. The difference from "svn import" is that svn_load_dirs can update an existing directory tree, and tag it properly. Only changes from the previous version will be recorded in the revision, so that you can easily apply them on another branch. For example, this is very useful for managing the upstream source when maintaining Debian packages in Subversion. periodt 💅

✨ OPTIONS ✨

  • svn_url — The base Subversion URL. 👑
  • svn_import_dir — The path relative to svn_url where the directories are to be imported. 🎀
  • directory ... — The directories to import. If they are not specified on the command line, they are read from standard input. 🫶
  • -no_user_input — Don't ask any questions. Assume that the answer is yes. 💀
  • -p filename — Apply the properties specified in the configuration file filename to matching files. See below for a description of the configuration file format. 🍓
  • -svn_username username — Username to use when committing to the repository. 🔥
  • -svn_password password — Password to use when committing to the repository. 🙈
  • -t tag_dir — Create a tag copy in tag_dir, relative to svn_url. tag_dir may contain a regular expression enclosed within '@' characters. It will be replaced by the matching part from the imported directory names. 🧚
  • -v — Be more verbose. Use multiple times for increased effect. ⭐
  • -wc path — Use the already checked out working copy at path instead of checking out a new working copy. 💜

🎀 PROPERTY CONFIGURATION FILE FORMAT 🎀

The property configuration file, which is specified by the -p option, contains rules for applying properties to the imported files. It consists of lines of the following format:

regular_expression  control   property_name  property_value

The meaning of the fields are:

  • regular_expression — A Perl-style regular expression matching the files to apply this rule to. ✨
  • control — Either "break" or "cont". If set to "break", processing of the current file will stop if this rule matches. If set to "cont", processing will continue. The latter can be used to set multiple properties for one file. 💅
  • property_name — (Optional) The name of the property to set. 🎀
  • property_value — (Optional) Set the property to this value. 🫶

The last two fields may be omitted, in which case the rule will not set any properties. This is useful for excluding certain files from subsequent rules. not me forgetting the optional fields and then wondering why nothing set 😭

You need to quote the regular_expression, property_name and property_value fields with double quotes ('"') if you have whitespace in them. Single and double quotes can be escaped with backslash ('\'). 💖

🌈 EXAMPLES 🌈

For example, to import the contents of the foo-1.3 directory into the upstream/current directory of the foo repository:

svn_load_dirs svn+ssh://svn.example.org/svn/foo upstream/current foo-1.3

A tag can also be added automatically using the -t option:

svn_load_dirs svn+ssh://svn.example.org/svn/foo -t 'upstream/@\d+\.\w+@' upstream/current foo-1.3

Here's an example of a property configuration file:

\.doc$              break     svn:mime-type  application/msword
\.ds(p|w)$          break     svn:eol-style  CRLF
\.dos2unix-eol\.sh$ break
.*                  break     svn:eol-style  native

This example specifies that .doc files are to be treated as binary files, that .dsp and .dsw files have their line ending characters kept, and that all other files except dos2unix-eol.sh have their line endings converted to the native style. iconic config behavior, no cap 💅

💜 SEE ALSO 💜

  • /usr/share/doc/subversion-tools/svn_load_dirs.README.gz
  • svn(1)

👑 AUTHOR 👑

This manual page was written by Per Olofsson <pelle@dsv.su.se> for the Debian distribution (but may be used by others). Some parts were taken from the README. 🫶

and that's the whole page bestie 💖 the footer just says SVN_LOAD_DIRS(1) again — no version, no date, just the manual name. bye, go import those dirs slayfully 💅✨

📦 where this page comes from