Nick Mathewson
b1a571f038
Edits requested by teor
2020-03-23 09:27:16 -04:00
Bartosz Duszel
fd6a35eb59
Update README files with common style.
...
- external links use markdown's []() format,
- local files are formated with backquotes,
- duplicated new lines were removed,
- unnecesary single spaces were removed,
- broken links and local paths were updated.
2020-03-22 13:50:58 +01:00
Nick Mathewson
c9bd3579f7
Tweak a couple of URLs in gettingstarted.md
2020-02-24 08:10:20 -05:00
Nick Mathewson
455ea05bdf
Rename EndOfLifeTor to ReleaseSeriesLifecycle; expand it.
...
Closes ticket 30917.
2020-02-14 08:47:17 -05:00
Roger Dingledine
90bb4872b8
go in to fix one typo, end up fixing more
2020-02-03 23:21:58 -05:00
Nick Mathewson
7c76cedf0f
update doc/HACKING/ReleasingTor.md
2020-01-23 08:55:55 -05:00
Nick Mathewson
888a0be0b9
Define a "dircache" module.
...
For now, this module is enabled whenever the relay module is
enabled, and disabled whenever the relay module is disabled. Though
they are logically separate, the use cases for running one without
the other are rare enough that we don't really want to support
compiling them independently.
2020-01-16 07:48:17 -05:00
Nick Mathewson
9276c07a91
Merge remote-tracking branch 'tor-github/pr/1615'
2020-01-06 13:32:33 -05:00
Nick Mathewson
e08d07692f
Add documentation about building a TAGS file.
...
Patch from opara. Closes ticket 32779.
2020-01-06 13:31:30 -05:00
Mike Perry
b7dbb4a554
Add NSF support acknowledgment to circpad dev doc.
2019-12-17 17:10:40 -06:00
Mike Perry
981350815d
Add circuit padding developer and quickstart docs.
2019-12-16 22:00:54 +02:00
teor
68b6d85248
Merge branch 'maint-0.4.2'
...
Merge tor_free() notes with whitespace fixes.
2019-11-25 12:52:10 +10:00
teor
eb81704081
CodingStandards: Use consistent spacing
...
* 2 newlines before ====== headers
* 1 newline before ------ headers
2019-11-25 12:50:15 +10:00
teor
03867b3dd7
Merge branch 'maint-0.4.2'
2019-11-25 12:37:26 +10:00
teor
969ee5d77f
CodingStandards: Use the correct changes file format
...
And remove a duplicate description of the format.
Obviously correct changes to documentation.
2019-11-25 11:44:22 +10:00
Nick Mathewson
f221a7aaf6
Fold remainder of this-not-that.md into CodingStandards.md
2019-11-12 12:28:14 -05:00
Nick Mathewson
c11c1d0623
Merge remote-tracking branch 'tor-github/pr/1367'
2019-11-12 12:18:14 -05:00
Nick Mathewson
e39423c78c
Remove 01e-os-compat: the module docs cover this much better.
2019-11-12 12:14:56 -05:00
Nick Mathewson
6744f6b6bb
HACKING/design: move 01c-time.md into doxygen.
2019-11-12 12:14:14 -05:00
Nick Mathewson
b0f9ecdbb1
Move 01g-strings.md into doxygen.
2019-11-12 12:09:53 -05:00
Nick Mathewson
d1a1631a05
01f-threads.md becomes threading.dox.
2019-11-12 12:05:05 -05:00
Nick Mathewson
91f377deec
HACKING/design: turn the remaining parts of crypto into a certs doc
2019-11-12 12:01:33 -05:00
Nick Mathewson
89396bc726
HACKING/design: remove 03-modules as superseded.
...
The src/feature directory documentation now covers this better.
2019-11-12 11:56:53 -05:00
Nick Mathewson
58d7f9e68b
Remove Makefile from doc/HACKING/design
2019-11-06 15:47:29 -05:00
Nick Mathewson
83cab05398
Remove 00-overview.md as already subsumed by doxygen
2019-11-06 15:47:00 -05:00
Nick Mathewson
3ae87c3c7f
Turn the "dataflow" document into a doxygen page.
2019-11-06 12:50:57 -05:00
Nick Mathewson
e1cdca2e4f
directory-level doxygen for "src/core"
2019-11-04 16:28:28 -05:00
Nick Mathewson
607b1ff776
Move much of 00-overview.md into doxygen.
2019-11-04 12:24:46 -05:00
Nick Mathewson
a5085c52d0
Move most of crypto overview into doxygen.
2019-11-04 12:10:28 -05:00
Nick Mathewson
211a2e0a8f
Move doc/HACKING/design/01b-collections.md into doxygen.
2019-11-04 12:07:38 -05:00
Nick Mathewson
fb20618e28
Divide 01a-memory.md into doxygen.
2019-11-04 12:04:32 -05:00
Nick Mathewson
4bf73dfa26
Remove now-superseded part of doc/HACKING/design.
2019-11-04 11:52:49 -05:00
teor
0973575737
doc/HACKING: Update Module.md for the relay module
...
Also fix some typos, and delete some obsolete instructions.
Part of 32123.
2019-10-20 20:26:06 +10:00
Nick Mathewson
1332d3b6fa
doc/HACKING/design: address comments from ahf
2019-10-14 15:53:04 -04:00
Nick Mathewson
358436592b
Edit 01b-collections.md a bit for md and missing content
2019-10-14 15:05:47 -04:00
Nick Mathewson
77accf937e
Edit 01a-memory.md
2019-10-14 15:02:26 -04:00
Nick Mathewson
8ef5d96c2e
Rewrite "common" overview into a "lib" overview.
2019-10-14 13:49:27 -04:00
Nick Mathewson
908070bbd5
Rename common-utils to lib-overview.
2019-10-14 10:59:32 -04:00
Nick Mathewson
1b996b01f6
00-overview.md: Revise to describe intended document structure
2019-10-14 10:58:03 -04:00
Roger Dingledine
aa56465934
fix typo in how-to-review guidelines
2019-10-07 00:48:11 -04:00
rl1987
b4aeeb77ba
Merge advice from this_not_that.md in torguts repo into our main coding standard doc
2019-09-25 17:15:12 +03:00
Nick Mathewson
469051f650
Copy architectural documentation from tor-guts.git repository
...
I started this repository a while ago to work on documentation for
Tor's internals. It needs substantial revision, but first, let's
get it copied into Tor's repository.
These files are copied, "warts and all", from the tor-guts.git repo,
commit de1e34259178b09861c0dea319c760fa80d0099a.
Part of 31819.
2019-09-24 19:26:04 -04:00
Antoine Veuiller
3bf90e704c
doc(hacking): update = to # on sections
2019-08-21 16:22:37 +02:00
Antoine Veuiller
0d6c8eed49
doc(hacking): enhance markdown style
2019-08-21 16:22:08 +02:00
Nick Mathewson
4313f1cce8
Merge branch 'ticket28453_v2' into ticket28453_v2_merged
2019-06-11 10:22:37 -04:00
Nick Mathewson
765e4364d9
Merge remote-tracking branch 'tor-github/pr/1064' into maint-0.4.1
2019-06-10 09:37:17 -04:00
Nick Mathewson
4ceec4760c
change some CI-substitute logic
2019-06-05 15:38:25 -04:00
rl1987
5d4b4f948a
Mention Travis/Appveyor/Jenkins URLs in ReleasingTor.md
2019-05-31 09:35:19 +03:00
Nick Mathewson
d41427b054
A couple of suggestions from dgoulet on EndOfLife.md
2019-05-30 09:07:45 -04:00
Nick Mathewson
3ba2e04ee7
Minor tweaks on EOL process
...
First, clarify that this is for planned deprecations, not
security-related issues.
Second, we actually _don't_ want to remove the versions from the
approved list before the EOL date, or people will start getting
warnings too early.
2019-05-30 09:05:35 -04:00
teor
6263d9e13f
doc: Add End of Life Tor instructions
...
Closes 28453.
2019-05-30 09:02:13 -04:00
teor
c390f1dd7e
doc: Add a new Travis CI cron job when there's a new maint branch
...
Part of 28453.
2019-05-30 09:02:13 -04:00
Nick Mathewson
d20cfc00ce
Note how to update the new website in the ReleasingTor.md instructions
2019-05-03 08:51:28 -04:00
teor
ac5753d3ca
Coding Standards: Document how to find git commits
...
Document how to find git commits and tags for bug fixes in
CodingStandards.md.
And update some changes file documentation.
Closes ticket 30261.
2019-04-23 10:03:18 +10:00
Elichai Turkel
0ebe290198
Removed the use of expect from CodingStandardsRust
2019-04-03 08:32:10 -04:00
Nick Mathewson
e2512950b6
Improve failure message from check-best-practices
2019-03-13 09:27:29 -04:00
Roger Dingledine
5dcd44cbe2
fix some of the typos in Maintaining.md
2019-02-17 16:55:55 -05:00
Nick Mathewson
b915b6cd21
Merge remote-tracking branch 'github/prop297'
2018-12-11 09:44:57 -05:00
Nick Mathewson
1f6d7bc4af
Update ReleasingTor.md to reflect current practice
...
See #28479 .
2018-12-05 07:58:53 -05:00
Nick Mathewson
b16d6453ad
Rewrite updateVersions script in Python, add datestamp functionality.
...
This updateVersions.pl script was one of the only essential perl
scripts left in out maint system, and was the only one that used
autoconf to fill in the script.
This script adds a feature to define an APPROX_RELEASE_DATE macro
that is updated when the version changes. We'll use this to
implement prop297, so that we have an accurate view of when a
release date happens.
2018-11-24 20:44:37 -05:00
Nick Mathewson
ed8a853bd8
Merge branch 'ticket28225_036_01_squashed'
2018-10-29 16:30:44 -04:00
David Goulet
91748cd17c
doc: Add Maintaining.md documentation
...
Closes #28225
Signed-off-by: David Goulet <dgoulet@torproject.org>
2018-10-29 16:30:34 -04:00
teor
b0c456e578
doc: Use `` for commands and "" for quotes in ReleasingTor.md
2018-10-29 13:49:47 +10:00
teor
fe89d9df69
doc: Spell make test-network-all correctly in ReleasingTor.md
...
Closes ticket 28821.
2018-10-29 13:47:43 +10:00
rl1987
d49133d9ca
Mention that we require Python 2.7 or newer
2018-09-24 11:25:33 -04:00
Nick Mathewson
c8aecd14fe
Merge branch 'pr275_squashed'
2018-08-16 08:43:05 -04:00
cypherpunks
fef2ba2267
rust/docs: fix critical typo for missing_docs lint
...
Fix typo from fe66d06a45
.
The exclamation point is what lets an attribute apply to
an entire crate, without the ! it's practically a placebo.
Fix on commits af182d4ab5
and
b6059297d7
, and note there are
still missing docs in both crypto and protover, for now.
https://doc.rust-lang.org/reference/attributes.html
2018-08-16 08:42:57 -04:00
Nick Mathewson
a7ea639f12
Merge branch 'maint-0.3.4'
2018-08-16 08:35:31 -04:00
Nick Mathewson
2deee972a3
Merge branch 'maint-0.3.3' into maint-0.3.4
2018-08-16 08:35:31 -04:00
Nick Mathewson
4847e22168
Merge branch 'maint-0.3.2' into maint-0.3.3
2018-08-16 08:35:27 -04:00
teor
db3414dd51
Rust: Say that we support rust stable in GettingStartedRust.md
...
In 24765, we said that we supported rust stable in CodingStandardsRust.md.
But we left GettingStartedRust.md saying that we support rust nightly.
Closes 27160.
2018-08-16 18:58:47 +10:00
teor
62ecb5e88f
doc: Document Appveyor and Jenkins in doc/HACKING/HelpfulTools.md
...
Closes 26852.
2018-07-18 12:11:08 +10:00
Roger Dingledine
baff5e2b9d
Faravahar hasn't been voting on versions for a while now
2018-07-13 16:58:46 -04:00
Nick Mathewson
4793d91350
Describe "check-includes" in the CodingStandards.md file
2018-07-10 11:09:25 -04:00
Nick Mathewson
fa2d53aa6a
Stop mentioning src/or and src/common in doc/HACKING
2018-07-10 11:03:45 -04:00
Nick Mathewson
23dc770f87
Add an initial CodeStructure.md file to doc/HACKING.
...
Not complete or pretty, but better than nothing.
2018-07-10 11:01:09 -04:00
Nick Mathewson
f720a5a439
Fix everything that previously referred to src/or
2018-07-05 17:15:50 -04:00
Nick Mathewson
81cb0afb2b
Start splitting src/or
...
This is a very gentle commit that just lays the groundwork in the
build system: it puts the include files to build libtor-app.a into
src/core, and to build the tor executable into src/app. The
executable is now "src/app/tor".
2018-07-05 17:15:50 -04:00
Nick Mathewson
9fa73003fc
Remove dmalloc support; closes #26426
...
Dmalloc hasn't seen a release in over a decade, and there are much
better tools to use these days.
2018-06-20 10:21:34 -04:00
Nick Mathewson
9af6c48d24
remove EOL@EOF advice
2018-06-18 16:18:44 -04:00
juga0
cc09ff253e
Add explanation about editorconf in coding standards
...
so that developers know what is .editorconfig for.
2018-06-11 21:29:40 +00:00
Nick Mathewson
f7949a440f
Add a CONTRIBUTING file
...
This file contains pointers to other important top-level resources,
and some info about acceptable licenses. Also, add that info to
CodingStandards.md
2018-05-11 13:19:37 -04:00
Alex Xu (Hello71)
2a3998a2e8
Add Travis CI instructions. fixes #23883
2018-05-08 09:12:46 -04:00
David Goulet
e12d4286bf
doc: Add Module.md explaining Tor modules
...
Initial document that contains guidelines to write a new module in Tor.
Closes #25991
Signed-off-by: David Goulet <dgoulet@torproject.org>
2018-05-03 11:39:19 -04:00
Nick Mathewson
def2404083
typo fix in doc/HACKING/ReleasingTor
2018-03-29 11:08:09 -04:00
Nick Mathewson
a3c1d78c29
Merge branch 'maint-0.3.3'
2018-03-28 08:11:46 -04:00
Georg Koppen
684aef40f9
Bug 25664: Update libc version requirement for Rust
...
When merging the patches for #25310 the libc version requirement in
`GettingStartedRust.md` and `configure.ac` did not get updated to the
now needed 0.2.39.
2018-03-28 08:07:27 -04:00
Nick Mathewson
03e787e220
Merge branch 'maint-0.3.3'
2018-03-21 17:05:42 -04:00
Isis Lovecruft
9799394375
maint: Add script for vendoring/updating Rust dependencies.
...
* ADD documentation for usage both inside the script and in
doc/HACKING/CodingStandardsRust.md
* FIXES part of #25310 : https://bugs.torproject.org/25310
2018-03-21 17:04:28 -04:00
Isis Lovecruft
f9ccb2543d
doc: Document our current rough-draft policy on Rust dependencies.
...
* FIXES #25310 : https://bugs.torproject.org/25310
2018-03-21 17:04:04 -04:00
Nick Mathewson
cae7387ef2
Merge branch 'maint-0.3.3'
2018-03-20 07:59:13 -04:00
Nick Mathewson
74c767af29
Note that we require latest stable rust.
2018-03-20 07:58:29 -04:00
teor
01a977b492
Update the primitive types explanation in the Rust coding standards
...
Part of #25368 .
Includes c_double in anticipation of #23061 .
2018-02-27 15:55:13 +11:00
Nick Mathewson
d489e4847b
Fix a variable name in tor-rust-dependencies
2018-02-21 11:55:25 -05:00
Nick Mathewson
d2bdb54d37
Wrap GettingStartedRust.md to 72 columns.
2018-02-21 11:55:07 -05:00
Deepesh Pathak
ca6682f3f8
Fix spelling mistakes corresponding to ticket #23650
2018-02-07 10:41:57 -05:00
Nick Mathewson
03ab24b44c
Make more notes about important stuff in ReleasingTor.md
2018-01-26 14:39:08 -05:00
Nick Mathewson
73e5be5619
ReleasingTor.md: check for recommendation, listing on dl page
...
Closes ticket 23118.
2018-01-26 14:34:25 -05:00
teor
7b59199663
Fix a typo in CodingStandards.md
...
Closes #24596 .
2017-12-12 12:32:50 +11:00
Nick Mathewson
5ee0cccd49
Merge branch 'macro_free_v2_squashed'
2017-12-08 14:58:43 -05:00