author | Todd Zullinger <tmz@pobox.com> | 2010-09-06 13:31:26 (UTC) |
---|---|---|
committer | Lars Hjemli <hjemli@gmail.com> | 2010-09-19 17:12:51 (UTC) |
commit | 66df1134573dccd364394f8a177e3d94bfb1e8d1 (patch) (unidiff) | |
tree | 74ae35276c8ce71defdbba32d3bc9646f1c37ab5 /cgitrc.5.txt | |
parent | d7765df117d25fc015856598c06f4796e8cdbb27 (diff) | |
download | cgit-66df1134573dccd364394f8a177e3d94bfb1e8d1.zip cgit-66df1134573dccd364394f8a177e3d94bfb1e8d1.tar.gz cgit-66df1134573dccd364394f8a177e3d94bfb1e8d1.tar.bz2 |
Use example.com in documentation, per RFC 2606
Signed-off-by: Todd Zullinger <tmz@pobox.com>
Signed-off-by: Lars Hjemli <hjemli@gmail.com>
-rw-r--r-- | cgitrc.5.txt | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/cgitrc.5.txt b/cgitrc.5.txt index ce78d41..ea1b18a 100644 --- a/cgitrc.5.txt +++ b/cgitrc.5.txt | |||
@@ -379,176 +379,176 @@ repo.path:: | |||
379 | An absolute path to the repository directory. For non-bare repositories | 379 | An absolute path to the repository directory. For non-bare repositories |
380 | this is the .git-directory. Default value: none. | 380 | this is the .git-directory. Default value: none. |
381 | 381 | ||
382 | repo.readme:: | 382 | repo.readme:: |
383 | A path (relative to <repo.path>) which specifies a file to include | 383 | A path (relative to <repo.path>) which specifies a file to include |
384 | verbatim as the "About" page for this repo. You may also specify a | 384 | verbatim as the "About" page for this repo. You may also specify a |
385 | git refspec by head or by hash by prepending the refspec followed by | 385 | git refspec by head or by hash by prepending the refspec followed by |
386 | a colon. For example, "master:docs/readme.mkd" Default value: <readme>. | 386 | a colon. For example, "master:docs/readme.mkd" Default value: <readme>. |
387 | 387 | ||
388 | repo.snapshots:: | 388 | repo.snapshots:: |
389 | A mask of allowed snapshot-formats for this repo, restricted by the | 389 | A mask of allowed snapshot-formats for this repo, restricted by the |
390 | "snapshots" global setting. Default value: <snapshots>. | 390 | "snapshots" global setting. Default value: <snapshots>. |
391 | 391 | ||
392 | repo.section:: | 392 | repo.section:: |
393 | Override the current section name for this repository. Default value: | 393 | Override the current section name for this repository. Default value: |
394 | none. | 394 | none. |
395 | 395 | ||
396 | repo.source-filter:: | 396 | repo.source-filter:: |
397 | Override the default source-filter. Default value: none. See also: | 397 | Override the default source-filter. Default value: none. See also: |
398 | "enable-filter-overrides". | 398 | "enable-filter-overrides". |
399 | 399 | ||
400 | repo.url:: | 400 | repo.url:: |
401 | The relative url used to access the repository. This must be the first | 401 | The relative url used to access the repository. This must be the first |
402 | setting specified for each repo. Default value: none. | 402 | setting specified for each repo. Default value: none. |
403 | 403 | ||
404 | 404 | ||
405 | REPOSITORY-SPECIFIC CGITRC FILE | 405 | REPOSITORY-SPECIFIC CGITRC FILE |
406 | ------------------------------- | 406 | ------------------------------- |
407 | When the option "scan-path" is used to auto-discover git repositories, cgit | 407 | When the option "scan-path" is used to auto-discover git repositories, cgit |
408 | will try to parse the file "cgitrc" within any found repository. Such a | 408 | will try to parse the file "cgitrc" within any found repository. Such a |
409 | repo-specific config file may contain any of the repo-specific options | 409 | repo-specific config file may contain any of the repo-specific options |
410 | described above, except "repo.url" and "repo.path". Additionally, the "filter" | 410 | described above, except "repo.url" and "repo.path". Additionally, the "filter" |
411 | options are only acknowledged in repo-specific config files when | 411 | options are only acknowledged in repo-specific config files when |
412 | "enable-filter-overrides" is set to "1". | 412 | "enable-filter-overrides" is set to "1". |
413 | 413 | ||
414 | Note: the "repo." prefix is dropped from the option names in repo-specific | 414 | Note: the "repo." prefix is dropped from the option names in repo-specific |
415 | config files, e.g. "repo.desc" becomes "desc". | 415 | config files, e.g. "repo.desc" becomes "desc". |
416 | 416 | ||
417 | 417 | ||
418 | EXAMPLE CGITRC FILE | 418 | EXAMPLE CGITRC FILE |
419 | ------------------- | 419 | ------------------- |
420 | 420 | ||
421 | .... | 421 | .... |
422 | # Enable caching of up to 1000 output entriess | 422 | # Enable caching of up to 1000 output entriess |
423 | cache-size=1000 | 423 | cache-size=1000 |
424 | 424 | ||
425 | 425 | ||
426 | # Specify some default clone prefixes | 426 | # Specify some default clone prefixes |
427 | clone-prefix=git://foobar.com ssh://foobar.com/pub/git http://foobar.com/git | 427 | clone-prefix=git://example.com ssh://example.com/pub/git http://example.com/git |
428 | 428 | ||
429 | # Specify the css url | 429 | # Specify the css url |
430 | css=/css/cgit.css | 430 | css=/css/cgit.css |
431 | 431 | ||
432 | 432 | ||
433 | # Show extra links for each repository on the index page | 433 | # Show extra links for each repository on the index page |
434 | enable-index-links=1 | 434 | enable-index-links=1 |
435 | 435 | ||
436 | 436 | ||
437 | # Show number of affected files per commit on the log pages | 437 | # Show number of affected files per commit on the log pages |
438 | enable-log-filecount=1 | 438 | enable-log-filecount=1 |
439 | 439 | ||
440 | 440 | ||
441 | # Show number of added/removed lines per commit on the log pages | 441 | # Show number of added/removed lines per commit on the log pages |
442 | enable-log-linecount=1 | 442 | enable-log-linecount=1 |
443 | 443 | ||
444 | 444 | ||
445 | # Add a cgit favicon | 445 | # Add a cgit favicon |
446 | favicon=/favicon.ico | 446 | favicon=/favicon.ico |
447 | 447 | ||
448 | 448 | ||
449 | # Use a custom logo | 449 | # Use a custom logo |
450 | logo=/img/mylogo.png | 450 | logo=/img/mylogo.png |
451 | 451 | ||
452 | 452 | ||
453 | # Enable statistics per week, month and quarter | 453 | # Enable statistics per week, month and quarter |
454 | max-stats=quarter | 454 | max-stats=quarter |
455 | 455 | ||
456 | 456 | ||
457 | # Set the title and heading of the repository index page | 457 | # Set the title and heading of the repository index page |
458 | root-title=foobar.com git repositories | 458 | root-title=example.com git repositories |
459 | 459 | ||
460 | 460 | ||
461 | # Set a subheading for the repository index page | 461 | # Set a subheading for the repository index page |
462 | root-desc=tracking the foobar development | 462 | root-desc=tracking the foobar development |
463 | 463 | ||
464 | 464 | ||
465 | # Include some more info about foobar.com on the index page | 465 | # Include some more info about example.com on the index page |
466 | root-readme=/var/www/htdocs/about.html | 466 | root-readme=/var/www/htdocs/about.html |
467 | 467 | ||
468 | 468 | ||
469 | # Allow download of tar.gz, tar.bz2 and zip-files | 469 | # Allow download of tar.gz, tar.bz2 and zip-files |
470 | snapshots=tar.gz tar.bz2 zip | 470 | snapshots=tar.gz tar.bz2 zip |
471 | 471 | ||
472 | 472 | ||
473 | ## | 473 | ## |
474 | ## List of common mimetypes | 474 | ## List of common mimetypes |
475 | ## | 475 | ## |
476 | 476 | ||
477 | mimetype.gif=image/gif | 477 | mimetype.gif=image/gif |
478 | mimetype.html=text/html | 478 | mimetype.html=text/html |
479 | mimetype.jpg=image/jpeg | 479 | mimetype.jpg=image/jpeg |
480 | mimetype.jpeg=image/jpeg | 480 | mimetype.jpeg=image/jpeg |
481 | mimetype.pdf=application/pdf | 481 | mimetype.pdf=application/pdf |
482 | mimetype.png=image/png | 482 | mimetype.png=image/png |
483 | mimetype.svg=image/svg+xml | 483 | mimetype.svg=image/svg+xml |
484 | 484 | ||
485 | 485 | ||
486 | ## | 486 | ## |
487 | ## List of repositories. | 487 | ## List of repositories. |
488 | ## PS: Any repositories listed when section is unset will not be | 488 | ## PS: Any repositories listed when section is unset will not be |
489 | ## displayed under a section heading | 489 | ## displayed under a section heading |
490 | ## PPS: This list could be kept in a different file (e.g. '/etc/cgitrepos') | 490 | ## PPS: This list could be kept in a different file (e.g. '/etc/cgitrepos') |
491 | ## and included like this: | 491 | ## and included like this: |
492 | ## include=/etc/cgitrepos | 492 | ## include=/etc/cgitrepos |
493 | ## | 493 | ## |
494 | 494 | ||
495 | 495 | ||
496 | repo.url=foo | 496 | repo.url=foo |
497 | repo.path=/pub/git/foo.git | 497 | repo.path=/pub/git/foo.git |
498 | repo.desc=the master foo repository | 498 | repo.desc=the master foo repository |
499 | repo.owner=fooman@foobar.com | 499 | repo.owner=fooman@example.com |
500 | repo.readme=info/web/about.html | 500 | repo.readme=info/web/about.html |
501 | 501 | ||
502 | 502 | ||
503 | repo.url=bar | 503 | repo.url=bar |
504 | repo.path=/pub/git/bar.git | 504 | repo.path=/pub/git/bar.git |
505 | repo.desc=the bars for your foo | 505 | repo.desc=the bars for your foo |
506 | repo.owner=barman@foobar.com | 506 | repo.owner=barman@example.com |
507 | repo.readme=info/web/about.html | 507 | repo.readme=info/web/about.html |
508 | 508 | ||
509 | 509 | ||
510 | # The next repositories will be displayed under the 'extras' heading | 510 | # The next repositories will be displayed under the 'extras' heading |
511 | section=extras | 511 | section=extras |
512 | 512 | ||
513 | 513 | ||
514 | repo.url=baz | 514 | repo.url=baz |
515 | repo.path=/pub/git/baz.git | 515 | repo.path=/pub/git/baz.git |
516 | repo.desc=a set of extensions for bar users | 516 | repo.desc=a set of extensions for bar users |
517 | 517 | ||
518 | repo.url=wiz | 518 | repo.url=wiz |
519 | repo.path=/pub/git/wiz.git | 519 | repo.path=/pub/git/wiz.git |
520 | repo.desc=the wizard of foo | 520 | repo.desc=the wizard of foo |
521 | 521 | ||
522 | 522 | ||
523 | # Add some mirrored repositories | 523 | # Add some mirrored repositories |
524 | section=mirrors | 524 | section=mirrors |
525 | 525 | ||
526 | 526 | ||
527 | repo.url=git | 527 | repo.url=git |
528 | repo.path=/pub/git/git.git | 528 | repo.path=/pub/git/git.git |
529 | repo.desc=the dscm | 529 | repo.desc=the dscm |
530 | 530 | ||
531 | 531 | ||
532 | repo.url=linux | 532 | repo.url=linux |
533 | repo.path=/pub/git/linux.git | 533 | repo.path=/pub/git/linux.git |
534 | repo.desc=the kernel | 534 | repo.desc=the kernel |
535 | 535 | ||
536 | # Disable adhoc downloads of this repo | 536 | # Disable adhoc downloads of this repo |
537 | repo.snapshots=0 | 537 | repo.snapshots=0 |
538 | 538 | ||
539 | # Disable line-counts for this repo | 539 | # Disable line-counts for this repo |
540 | repo.enable-log-linecount=0 | 540 | repo.enable-log-linecount=0 |
541 | 541 | ||
542 | # Restrict the max statistics period for this repo | 542 | # Restrict the max statistics period for this repo |
543 | repo.max-stats=month | 543 | repo.max-stats=month |
544 | .... | 544 | .... |
545 | 545 | ||
546 | 546 | ||
547 | BUGS | 547 | BUGS |
548 | ---- | 548 | ---- |
549 | Comments currently cannot appear on the same line as a setting; the comment | 549 | Comments currently cannot appear on the same line as a setting; the comment |
550 | will be included as part of the value. E.g. this line: | 550 | will be included as part of the value. E.g. this line: |
551 | 551 | ||
552 | robots=index # allow indexing | 552 | robots=index # allow indexing |
553 | 553 | ||
554 | will generate the following html element: | 554 | will generate the following html element: |