$uclas ) { $trs .= TR ( TD ( $clas ) . TD ( $uclas -> dscr ) ) ; } return $res . BQ ( TAB ( $trs ) ) ; } function flatten_list ( $lst ) { $res = '' ; $cnt = count ( $lst ) ; if ( $cnt == 1 ) { $res = $lst [ 0 ] ; } elseif ( $cnt ) { $last = array_pop ( $lst ) ; $res = sprintf ( "%s and %s" , implode ( ', ', $lst ) , $last ) ; } return $res ; } function gen_tree_txt () { $clases = Conf ( 'clases' ) ; $trees = Conf ( 'trees' ) ; $creas = array () ; $trs = TR ( TH ( 'part' ) . TH ( 'full repo name' ) . TH ( "repo's can be created by" ) ) ; $repo = new Repo ; $hv_o = 0 ; foreach ( $trees as $path => $tree ) { $repo -> side = $path ; $repo -> ownr = 'owner' ; $repo -> name = 'name' ; $name = $repo -> repo_name ( 'red' ) ; $hv_o = $hv_o || preg_match ( '/%o/', $tree -> pref ) ; $crea = array () ; foreach ( array_keys ( $tree -> crea ) as $clas ) { $dscr = $clases [ $clas ] -> dscr ; $crea [] = $dscr ; $creas [ ITA ( $dscr ) ] ++ ; } if ( count ( $crea ) ) { sort ( $crea ) ; $ctxt = implode ( "
\n", $crea ) ; if ( ! $d0 ) { $d0 = $crea [ 0 ] ; $n0 = $name ; } } else { $ctxt = SPN ( "svn admins ; on request", 'red' ) ; } $trs .= TR ( TD ( $path ) . TD ( $name ) . TD ( $ctxt ) ) ; } $creas_txt = 'svn-admins, on request' ; if ( count ( $creas ) ) { ksort ( $creas ) ; $creas_txt = flatten_list ( array_keys ( $creas ) ) ; } $tab = BQ ( TAB ( $trs ) ) ; $res = "the repository name space " ; if ( ( $cnt = count ( $trees ) ) == 1 ) { return array ( "$res is flat :" . $tab , $creas_txt ) ; } $res .= "has $cnt parts :\n" ; $res .= $tab ; if ( $hv_o ) { $holi = LI ( SPN ( 'owner', 'red' ) . " is the login-name " . "of the creator of the repository" ) ; } $res .= "where ...\n" ; $res .= UL ( $holi . LI ( SPN ( 'name', 'red' ) . ' ' . 'can be chosen by the owner/creator' ) ) ; $res .= "

Users in different classes, can create repositories in " . "different parts." ; if ( $d0 ) { $res .= "
\nFor instance, $d0 can create repositories " . "with names like

$n0

" ; } return array ( $res, $creas_txt ) ; } $user_txt = gen_user_txt () ; list ( $tree_txt, $creas_txt ) = gen_tree_txt () ; if ( Conf () -> have_guests () ) { $li_guests = LI ( 'In this repocafe, ' . "guest accounts can be created.\n" ) ; if ( $creag = Conf ( 'creag' ) ) { $tmp = array () ; foreach ( $creag as $clas => $uclas ) { $tmp [] = ITA ( $uclas -> dscr ) ; } $lst = implode ( ', ', $tmp ) ; $li_guests_crea = LI ( "Guest accounts can also be created by : $lst.\n" ) ; } } else { $li_guests = LI ( 'In this repocafe, ' . 'guest accounts ' . SPN ( "can't be created", 'red' ) . ".\n" . "The points below are just for your information." ) ; } if ( ! Conf ( 'has_groups' ) ) { $li_groups = LI ( 'In this repocafe, ' . 'groups ' . SPN ( "can't be created", 'red' ) . ".\n" . "The points below are just for your information." ) ; } $top_rules_usage = Conf ( 'top_rules_usage' ) ; $aux_rules_usage = Conf ( 'aux_rules_usage' ) ; $top_statistics = Conf ( 'top_statistics' ) ; $aux_statistics = Conf ( 'aux_statistics' ) ; $TIT = REPO_TIT ( 'documentation' ) ; html_start ( $TIT ) ; if ( file_exists ( 'images/tots.png' ) ) { $img = '

' . "\n" ; echo URL ( "#s", $img ) ; $img_stats = BQ ( '

' ) ; } echo H4 ( 'contents' ) ; echo "

" ; echo UL ( LI ( namref ( '1', 'general' ) ) . LI ( namref ( '2', 'repository name space' ) ) . LI ( namref ( '3', 'repository properties' ) ) . LI ( namref ( 'p', 'path rights & permissions' ) ) . LI ( namref ( '4', 'using the repository service' ) . UL ( LI ( namref ( '41', 'creating a repository' ) ) . LI ( namref ( '42', 'migration : (up)loading a repository' ) ) ) ) . LI ( namref ( '5', 'guests' ) ) . LI ( namref ( '6', 'user groups' ) ) . LI ( namref ( '7', 'rules - usage' ) ) . LI ( namref ( '8', 'rules - cleanup' ) ) . LI ( namref ( 's', 'statistics' ) ) . LI ( namref ( 'c', 'contact' ) ) ) ; echo "

\n" ; echo "
\n" ; echo <<general

$subv_url provides a version control service, using the subversion system, documented in the subversion book.
This service is provided by $organisation ; $cnt_repos repositories now exist.
Svn-admins can and will do periodic cleanups ; see cleanup.

repository name space

$user_txt
$tree_txt

repository properties

A repository is either public or private ; public repositories can be browsed, checked out, etc without authentication (login).
Repositories can be created by $creas_txt.
The owner of a repository, is (the login-name of) the creator of the repository.
When a repository is created, the owner is a manager, has commit rights, and is a watcher.
A manager of a repository can change the properties of the repository ; a manager can also delete the repository.
A manager can set read or commit access rights for (groups of) users.
A manager can grant manager rights to other users.
A watcher is a user who receives email notification of commits ; the watchers of a repository are appointed by a manager of the repository.

path rights & permissions

In addition to repository root, rights & permissions can be be set for paths within a repository.
A permission path can be added or deleted by any manager of repository root.
Adding (or deleting) a permission path doesn't affect the contents of the repository.
A path must a be list of alpha-numeric names, separated by slashes.
To evaluate the permissions of user U on any path P, repocafe inspects (only) the permissions defined for U ;
of those, the most specific set is used ; that is, the permissions of the longest permission path which is a prefix of P.
After a commit, repocafe attempts to notify (by mail) the repository's watchers. It inspects the diff, which contains various parts.
A user is notified if he/she is a watcher of any part. The notification mail contains only the relevant parts of the diff.

using the repository service

creating a repository

using the web forms, create a repository, say staff.henkp.jinx
in the repository's info page, you see a browse, checkout url :
```
  $www_scheme://$www_server/repos/staff.henkp.jinx
```
you can checkout the new, empty repository on your own computer :
```
  svn checkout $www_scheme://$www_server/repos/staff.henkp.jinx
```
this creates your local copy of the repository staff.henkp.jinx

now create some stuff in the local copy and svn-add it

  cd staff.henkp.jinx
  svn mkdir aap
  vi aap/noot
  svn add aap/noot

... and commit the stuff to the $www_server repository :
```
  svn commit -m 'added some aap noot mies'
```
You should receive some mail about the changes that you made.
if you now visit the browse url
```
  $www_scheme://$www_server/repos/staff.henkp.jinx
```
you should see your stuff in the $www_server repository.

migration : (up)loading a repository

In a new (revision 0) repository, you can upload the svn dump of some existing repository.
Loading only works for dumps that aren't too big ; currently the limit is set at 22MB (gzip compressed).
To migrate a bigger repository :
- make a dump of the old repository (source)
- create a new, empty (destination) repository on $www_server
- contact svn-admins ; please specify the location of the source and the name of the destination repository

guests

Guests can have read and commit rights ; they can be watchers, but not managers.
Guest users can change their password and send themselves the password, if/when they have forgotten it.
Guest accounts can be created on request by svn-admins ; please supply the guest's full name and email address. $li_guests_crea

user groups

To facilitate easier access management, simple groups of users can be defined.
A group manager can modify the group : update membership and appoint other managers.
Only repository read and commit rights can be assigned to groups.

rules - usage

Please remove obsolete repositories.
The repository service is intended for data stores that require version control and/or maintenance by groups of people.
The service can support a large number of repositories, but total size is limited ;
so, create as many repositories as you need, but try to keep the total size down.
Remember that the only way to 'clean up' a repository, is to remove it ; so, do be careful when you put stuff in. $aux_rules_usage

rules - cleanup

Svn-admins will remove repositories, if/when the owner's account is removed.
It is the user's responsibility to transfer a repository's contents before removal.
Svn-admins may remove old, empty (revision 0) repositories.

statistics

There are now $cnt_repos repositories.
Statistics (size and revision) are gathered every day, but per repo statistics are kept only once a week.
Per repo statistics plots are shown when there are statistics for at least two days. $aux_statistics

$img_stats

contact

send questions, comments and requests to $contact.

TXT; echo html_end () ; # phpinfo() ; ?>