File: tcllib_sources.man

package info (click to toggle)
tcllib 2.0%2Bdfsg-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 83,560 kB
  • sloc: tcl: 306,798; ansic: 14,272; sh: 3,035; xml: 1,766; yacc: 1,157; pascal: 881; makefile: 124; perl: 84; f90: 84; python: 33; ruby: 13; php: 11
file content (96 lines) | stat: -rw-r--r-- 2,942 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
[comment {-*- tcl -*- doctools manpage}]
[manpage_begin tcllib_sources n 1]
[titledesc {Tcllib - How To Get The Sources}]
[description]
[include parts/welcome.inc]

[para]

The audience of this document is anyone wishing to either have just a
look at Tcllib's source code, or build the packages, or to extend and
modify them.

[para] For builders and developers we additionally provide

[list_begin enum]
[enum] [term {Tcllib - The Installer's Guide}].
[enum] [term {Tcllib - The Developer's Guide}].
[list_end]

respectively.

[section {Source Location}]

The official repository for Tcllib is found at [uri http://core.tcl-lang.org/tcllib].

This repository is managed by the [uri http://www.fossil-scm.org {Fossil SCM}].

[section {Get archives for head and releases}]

This is done easiest by going to the
[uri http://core.tcl-lang.org/tcllib {official repository}]
and following the links in the [strong Releases] section at the top,
immediately underneath the entry field for searching the package
documentation.

[section {Retrieval of arbitrary commits}]

For anything beyond head state and releases the process is a bit more
involved.

[para] If the commit id (commit hash) [const ((ID))] of the revision
of interest is already known then links to the desired archives can be
constructed using the forms below:

[example {
    https://core.tcl-lang.org/tcllib/tarball/((ID))/Tcl+Library+Source+Code.tar.gz
    https://core.tcl-lang.org/tcllib/zip/((ID))/Tcl+Library+Source+Code.zip
}]

Note that branch names can be used for the [const ((ID))] also, this
returns archives containing the head revision of the named branch.

[para] The part of of the url after the [const ((ID))] is the name of
the file to return and can be modified to suit.

[para] Without a known commit id the process is longer again:

[list_begin enum]
[enum] Go to the [uri http://core.tcl-lang.org/tcllib {official repository}].
[enum] Find the login link/button in the top right corner of the page.
[enum] Log in as "anonymous", using the semi-random password in the captcha.
[enum] Go to the "Timeline" following the link/button in the middle of the nav bar.
[enum] Choose the revision you wish to have.
[enum] Follow its link to its detailed information page.
[enum] On that page, choose either the "ZIP" or "Tarball" link to get a copy
       of this revision in the format of your choice.
[list_end]

[section {Source Code Management}]

The sources are managed with the [uri http://www.fossil-scm.org {Fossil SCM}].

Binaries for popular platforms can be found directly at its
[uri http://www.fossil-scm.org/download.html {download page}].

[para]

With that tool available the full history can be retrieved via:

[example {
    fossil clone \
	http://core.tcl-lang.org/tcllib \
        tcllib.fossil
}]

followed by

[example {
    mkdir tcllib
    cd tcllib
    fossil open ../tcllib.fossil
}]

to get a checkout of the head of the trunk.

[manpage_end]