Brian Anderson
e7d7f4e4b7
rustdoc: Add a demo module with some test docs
2012-01-24 23:24:54 -08:00
Brian Anderson
45a668c439
rustdoc: Update tests for rustc diagnostic changes
2012-01-24 23:24:31 -08:00
Patrick Walton
9ecd5ee81d
rustc: Split diagnostics into "span diagnostics" and "diagnostics".
...
The former contain a codemap (which is per-crate), and the latter don't. This
will be useful in order to allow more than one crate to be compiled in one run
of the compiler.
2012-01-24 21:42:54 -08:00
Brian Anderson
4d096a8c86
rustdoc: Rename gen module to markdown_pass
2012-01-24 18:18:14 -08:00
Brian Anderson
dc69355e99
rustdoc: Generate markdown for failure conditions
2012-01-24 18:17:06 -08:00
Brian Anderson
3310112169
rustdoc: Trim whitespace from failure conditions
2012-01-24 18:10:35 -08:00
Brian Anderson
a66bff6e81
rustdoc: Don't prune functions with documented failure conditions
2012-01-24 18:08:48 -08:00
Brian Anderson
efc067952d
rustdoc: Add fn failure conditions to the doc tree
2012-01-24 18:05:57 -08:00
Brian Anderson
6d8058451b
rustdoc: Parse fn failure conditions
2012-01-24 18:02:33 -08:00
Brian Anderson
fc64aefe0a
rustdoc: Add a pass to trim whitespace from docs
2012-01-24 17:57:23 -08:00
Brian Anderson
cb44fa2a21
rustdoc: Add a pass that extracts brief docs from long docs
...
If the first paragraph of documentation is short then it will be used as the
brief description.
2012-01-24 17:57:23 -08:00
Brian Anderson
93686543e6
rustdoc: Update one of the markdown fn tests
2012-01-24 00:51:54 -08:00
Brian Anderson
c98cfa4f28
rustdoc: Write markdown for consts
2012-01-24 00:51:19 -08:00
Brian Anderson
74ab606e18
rustdoc: Prune undocumented consts
2012-01-24 00:44:47 -08:00
Brian Anderson
e3be8e689d
rustdoc: Some refactoring in attr_pass
2012-01-24 00:38:36 -08:00
Brian Anderson
fbd704e77d
rustdoc: Add const attr docs to doc tree
2012-01-24 00:38:35 -08:00
Brian Anderson
c93c6358cb
rustdoc: Add parsing of const attribute docs
2012-01-24 00:38:35 -08:00
Brian Anderson
e6ed88df68
rustdoc: Add const types to the doc tree
2012-01-24 00:38:35 -08:00
Brian Anderson
d4e9f097b6
rustdoc: Add brief and desc fields to constdoc
2012-01-24 00:38:35 -08:00
Brian Anderson
f9a6b3731f
rustdoc: Add fold_const and fold_constlist to fold
2012-01-24 00:38:35 -08:00
Brian Anderson
d66ac392fe
rustdoc: Prune unexported consts
2012-01-24 00:38:35 -08:00
Brian Anderson
ab86bade97
rustdoc: Build const docs from AST consts
2012-01-24 00:38:35 -08:00
Brian Anderson
6ee7ff50b2
rustdoc: Add consts to the doc tree
2012-01-24 00:38:35 -08:00
Brian Anderson
ab0eed34fd
rustdoc: Prune unexported items from the doc tree
2012-01-23 22:13:34 -08:00
Brian Anderson
ef941998be
rustdoc: Correctly indent multiline fn signatures
2012-01-23 17:58:52 -08:00
Brian Anderson
17ac98ba22
rustdoc: Use the standard markdown syntax for code blocks
2012-01-23 17:58:52 -08:00
Kevin Atkinson
ad21d9c64a
Don't reset the chpos/byte_pos to 0 in new_parser_from_source_str.
...
This correctly fixes issue #1362 .
chpos/byte_pos are now the offsets within a particular file, but
rather the offsets within a virtual file with is formed by combing all
of the modules within a crate. Thus, resetting them to 0 causes an
overlap and hence, bogus source locations.
Fix #1362 by moving chpos/byte_pos to parse_sess so that
new_parser_from_source_str has access to them and hence can chose an
initial value that is not already been used in the crate.
Note that the trigger for bug 1361 was that syntax/ext/expand.rs calls
parse_expr_from_source_str (which calls new_parser_from_source_str)
using the same codemap as the current crate (and hence causing overlap
with files in the crate as new_parser_from_source_str resets the
chpos/byte_pos to 0).
2012-01-23 17:37:15 -08:00
Brian Anderson
368daf8b5a
Change rustc and rustdoc's #[desc] attribute to #[comment]
...
There are two attributes in use for this same purpose.
2012-01-23 16:25:20 -08:00
Brian Anderson
50d8e9f2a1
Revert "rustdoc: Get the crate brief description from the 'desc' attr"
...
This reverts commit 521e58a3c4
.
Some crates use 'desc', some 'comment' - I want them to just use 'doc'
2012-01-23 16:23:08 -08:00
Brian Anderson
f4c31bda62
rustdoc: Print return value descriptions on same line as type
2012-01-23 16:18:01 -08:00
Brian Anderson
fa3368bc71
rustdoc: Prune undocumented return values
2012-01-23 16:18:01 -08:00
Brian Anderson
a7d3544d10
rustdoc: Don't prune functions with documented arguments
2012-01-23 16:18:01 -08:00
Brian Anderson
5cff7c093e
rustdoc: Prune undocumented fn args
2012-01-23 16:18:01 -08:00
Brian Anderson
e515999324
rustdoc: Prune undocumented modules
2012-01-23 15:40:01 -08:00
Brian Anderson
521e58a3c4
rustdoc: Get the crate brief description from the 'desc' attr
2012-01-23 15:16:14 -08:00
Graham Fawcett
7763b40c71
issue #1352 : change param order on vec::init_elt, putting block in final position.
...
To match the init_fn() and init_fn_mut() changes.
2012-01-21 13:33:16 -08:00
Graydon Hoare
7b1a8f0a91
Additional ; to , changes, disable "tag" and ";" in parser. Close #1430 . Close #1428 .
2012-01-19 19:29:21 -08:00
Brian Anderson
fdbe206a76
rustdoc: Make doc::retdoc non-optional
2012-01-19 19:14:29 -08:00
Brian Anderson
2d2bdfe845
rustdoc: Write markdown for function signatures
2012-01-19 18:59:02 -08:00
Brian Anderson
c6278e53dc
rustdoc: Remove debug logging
2012-01-19 18:36:20 -08:00
Brian Anderson
2a442f9f8f
rustdoc: Add function signatures to the doc tree
2012-01-19 18:14:17 -08:00
Brian Anderson
052340980b
rustdoc: Add function signature field to the doc::fndoc
2012-01-19 18:14:17 -08:00
Patrick Walton
035b56d8aa
misc: "tag" -> "enum" for cargo, compiletest, fuzzer, rustdoc
2012-01-19 16:21:33 -08:00
Brian Anderson
840a057556
rustdoc: Add a blank line after the return value description
2012-01-19 14:35:19 -08:00
Brian Anderson
df9bf1f45f
rustdoc: Attach return value descriptions to the doc tree
2012-01-19 14:35:18 -08:00
Brian Anderson
00afef0bd8
rustdoc: Run tystr pass before attr pass
2012-01-19 14:35:18 -08:00
Tim Chevalier
5b028f527f
Remove support for the '.' after a nullary tag in a pattern
...
(Commit also includes lots of changes to remove '.'s that a git
merge messed up, or else it was monkeys.)
2012-01-19 01:04:59 -08:00
Brian Anderson
9df0306889
rustdoc: Cleanup
2012-01-19 00:14:41 -08:00
Brian Anderson
f77458a676
rustdoc: Remove nullary-tag dots
2012-01-19 00:08:51 -08:00
Brian Anderson
398dadfeca
rustdoc: Write the full path to each mod
2012-01-19 00:04:59 -08:00
Brian Anderson
42e5d451b7
rustdoc: Change the header scheme so that all mods are h2, fns h3
2012-01-19 00:04:59 -08:00
Brian Anderson
a5e0f037be
rustdoc: Add path_pass for recording full paths to mods
2012-01-19 00:04:59 -08:00
Brian Anderson
c54f53b9d9
rustdoc: Add path field to doc::moddoc
2012-01-19 00:04:59 -08:00
Tim Chevalier
04a2887f87
Remove '.' after nullary tags in patterns
...
Does what it says on the tin.
The next commit will remove support for this syntax.
2012-01-18 23:17:34 -08:00
Brian Anderson
ca7cfbe3d0
rustdoc: Add more rustdocs
2012-01-18 23:11:20 -08:00
Brian Anderson
fb82e6ab79
rustdoc: Write fn arg descriptions to markdown
2012-01-18 22:40:06 -08:00
Brian Anderson
266cc7b0c3
rustdoc: Add fn arg descriptions to the doc tree
2012-01-18 22:24:29 -08:00
Brian Anderson
515fdb2863
rustdoc: Change field order on doc::fndoc
2012-01-18 21:57:18 -08:00
Brian Anderson
e9ddfbe3fd
rustdoc: Ignore nil-typed return values
2012-01-18 21:50:35 -08:00
Brian Anderson
a02a943cec
rustdoc: Write markdown for mod description
2012-01-18 21:33:37 -08:00
Brian Anderson
20b8509594
rustdoc: Add mod docs attrs to the doc tree
2012-01-18 19:59:24 -08:00
Brian Anderson
e39e34776e
rustdoc: Assign AST ids to mod docs
2012-01-18 19:59:24 -08:00
Brian Anderson
5bbf72e11c
rustdoc: Add brief and desc fields to module docs
2012-01-18 19:59:24 -08:00
Brian Anderson
08da893cdb
rustdoc: Parse module docs
2012-01-18 19:59:23 -08:00
Brian Anderson
2286d8c17e
rustdoc: Write argument names as code spans
2012-01-18 17:11:58 -08:00
Brian Anderson
c06e62e0ce
rustdoc: Write markdown for argument types
2012-01-18 17:10:04 -08:00
Brian Anderson
6da55efa4e
rustdoc: Add argument types to the doc
2012-01-18 17:05:03 -08:00
Brian Anderson
f3fa7c1555
rustdoc: Extract functions from tystr_pass::fold_fn
2012-01-18 16:09:32 -08:00
Brian Anderson
cbd7e8ed1b
rustdoc: Prune unconfigured items from AST
2012-01-18 15:48:09 -08:00
Brian Anderson
1b839a61c4
rustdoc: Write markdown for fn arguments
2012-01-18 15:02:43 -08:00
Brian Anderson
29df58d73b
rustdoc: Introduce type doc::argdoc
2012-01-18 15:02:43 -08:00
Brian Anderson
38852bf0a4
rustdoc: Extract function argument names from the AST
2012-01-18 15:02:43 -08:00
Brian Anderson
92f63b90f9
rustdoc: Merge the crate's name attribute into the doc tree
2012-01-18 15:02:43 -08:00
Brian Anderson
60b475ea88
rustdoc: Parse crate name from #[link] attr
2012-01-18 15:02:43 -08:00
Brian Anderson
810af2dada
rustdoc: Put fn docs inside fn bodies
2012-01-18 15:02:43 -08:00
Brian Anderson
9191911499
rustdoc: Document attr_parser::doc_meta
2012-01-18 15:02:42 -08:00
Brian Anderson
2d85e8f59a
rustdoc: Improve formatting of return type
2012-01-17 23:53:24 -08:00
Brian Anderson
6c295c0f49
rustdoc: Write a single line between brief and desc
2012-01-17 23:42:26 -08:00
Brian Anderson
c4d2cc4015
rustdoc: Extract various gen functions
2012-01-17 23:39:22 -08:00
Brian Anderson
c17d58d5ba
rustdoc: Extract boilerplate from gen tests
2012-01-17 23:33:11 -08:00
Brian Anderson
0142e807dd
rustdoc: Write blank lines after brief descriptions
2012-01-17 23:29:23 -08:00
Brian Anderson
971236e8f7
rustdoc: Remove some debug logging
2012-01-17 23:13:24 -08:00
Brian Anderson
e23e45bc6d
rustdoc: Add rustdocs
2012-01-17 17:45:37 -08:00
Brian Anderson
5fbadd24ec
rustdoc: Cleanup
2012-01-17 17:45:37 -08:00
Brian Anderson
cf31eca597
rustdoc: Write a blank line after headers
2012-01-17 16:31:26 -08:00
Brian Anderson
637f19965f
rustdoc: Convert markdown generation to a pass
2012-01-17 16:31:26 -08:00
Brian Anderson
a6bdaee7f9
rustdoc: Remove iface. Causing random crashes in resolve?
2012-01-17 16:31:26 -08:00
Lenny222
b19fdcced2
libstd => libcore
2012-01-17 10:51:43 -08:00
Lenny222
106dcf7b92
spin-off rustdocs tuple code to libstd
2012-01-17 10:51:43 -08:00
Brian Anderson
d367cdf1d9
rustdoc: Write headers for modules
2012-01-16 23:10:25 -08:00
Brian Anderson
b8840cbee6
rustdoc: Add a pass to prune undocumented items
2012-01-16 22:50:00 -08:00
Brian Anderson
ba41342279
rustdoc: Add gen::subsection for managing header levels
2012-01-16 22:01:25 -08:00
Brian Anderson
ab86642e35
rustdoc: Don't use by copy in fst/snd to work around segv
...
Issue #1546
2012-01-16 21:56:21 -08:00
Brian Anderson
27fe23dcaa
rustdoc: Refactor header writing a bit
2012-01-16 21:37:29 -08:00
Brian Anderson
bd63c3928e
rustc: Move some attribute accessors from rustdoc to rustc
2012-01-16 21:12:36 -08:00
Brian Anderson
4f2ad6b124
rustdoc: Move fst and snd into util mod
2012-01-16 21:12:36 -08:00
Brian Anderson
75dbb0f193
rustdoc: Use attr API in attr_parser
2012-01-16 21:12:36 -08:00
Brian Anderson
29409afe1a
rustdoc: Add a fallthrough path to meta_item search in parse_fn
2012-01-16 21:12:35 -08:00
Brian Anderson
cf40b60b5a
rustdoc: Begin writting the attribute extracting pass
2012-01-16 21:12:35 -08:00
Brian Anderson
a0ed75bc49
rustdoc: Use the parsing method that supports .rc files
2012-01-16 21:12:35 -08:00
Brian Anderson
645035a715
rustdoc: Convert tystr_pass to use astsrv
2012-01-16 21:12:35 -08:00
Brian Anderson
447f1fd4af
rustdoc: Add a pass type and a run_passes function
2012-01-16 21:12:35 -08:00
Brian Anderson
74d4989876
rustdoc: Add extract::from_srv to extract a doc from an astsrv
2012-01-16 21:12:35 -08:00
Brian Anderson
439a28abe0
rustdoc: Add module astsrv to provide access to the (non-sendable) AST
2012-01-16 21:12:35 -08:00
Brian Anderson
d455d46b15
rustdoc: Remove non-attribute related stuff from attr_parser
2012-01-16 21:12:35 -08:00
Brian Anderson
c87b820298
rustdoc: Add attr_pass for extracting attributes
2012-01-16 21:12:35 -08:00
Brian Anderson
b768df4ea3
rustdoc: Remove unused import from extract module
2012-01-16 21:12:35 -08:00
Brian Anderson
22d182acd7
rustdoc: Remove attribute parsing from extract module
2012-01-16 21:12:35 -08:00
Brian Anderson
04294e437b
rustdoc: Cleanup
2012-01-16 21:12:35 -08:00
Brian Anderson
6e0bcb5bd0
rustdoc: Eliminate AST usage in gen module
2012-01-16 21:12:34 -08:00
Brian Anderson
c4de718f37
rustdoc: Add tystr_pass module for extracting type strings
2012-01-16 21:12:34 -08:00
Brian Anderson
497814642f
rustdoc: Make fold polymorphic on a context type
...
This will allow it to be instantiated for non-sendable contexts
2012-01-16 21:12:34 -08:00
Brian Anderson
5457b4d3fb
rustdoc: Add fold module
2012-01-16 21:12:34 -08:00
Brian Anderson
e77b8db707
rustdoc: Convert fn return type to retdoc record
2012-01-16 21:12:34 -08:00
Brian Anderson
63dcc64275
rustdoc: Change fndoc's arg list to a vec from map
2012-01-16 21:12:34 -08:00
Brian Anderson
b6ad840c18
rustdoc: Make gen module exports explicit
2012-01-16 21:12:34 -08:00
Brian Anderson
5f25804f46
rustdoc: Push imports down into submodules
2012-01-16 21:12:34 -08:00
Brian Anderson
b39154233a
rustdoc: Attach the doc writer to the doc extractor
2012-01-16 01:07:42 -08:00
Brian Anderson
a8428a896e
rustdoc: Write fn docs
2012-01-16 01:07:42 -08:00
Brian Anderson
d928952191
rustdoc: Write crate name
2012-01-16 01:07:42 -08:00
Brian Anderson
ae584263da
rustdoc: Set the crate name in the top module
2012-01-16 01:07:42 -08:00
Brian Anderson
77690baa70
rustdoc: Attach the AST node id to fndocs
2012-01-16 01:07:42 -08:00
Brian Anderson
7a9ba240a0
rustdoc: Rename type rustdoc to gen::ctxt
2012-01-16 01:07:42 -08:00
Brian Anderson
906a7c2174
rustdoc: Move rustdoc type into the gen module
2012-01-16 01:07:42 -08:00
Brian Anderson
237d96512a
rustdoc: Wire up the doc extractor to attribute parser
2012-01-16 01:07:42 -08:00
Brian Anderson
763f3c4d5b
rustdoc: Add regression tests for existing attr parsing behavior
2012-01-16 01:07:42 -08:00
Brian Anderson
01fedcad77
rustdoc: Change parse_fn to take a vector of attributes
2012-01-16 01:07:42 -08:00
Brian Anderson
d85fa7c8dc
rustdoc: Rename parse_compound_fndoc to parse_fn
2012-01-16 01:07:42 -08:00
Brian Anderson
f3c4263635
rustdoc: Move parse_compound_fndoc into mod attr_parser
2012-01-16 01:07:42 -08:00
Brian Anderson
46a662ecb2
rustdoc: Build mod and fn nodes from the AST
2012-01-16 01:07:42 -08:00
Brian Anderson
995c50b69b
rustdoc: Add extract module for building doc model from AST
2012-01-16 01:07:41 -08:00
Brian Anderson
555d5aed37
rustdoc: Move markdown-writing functions into gen module
2012-01-16 01:07:41 -08:00
Brian Anderson
140fbd3019
rustdoc: Move document model into doc module
2012-01-16 01:07:41 -08:00
Brian Anderson
e32cf827ff
rustdoc: Add cratedoc and moddoc types
2012-01-16 01:07:41 -08:00
Brian Anderson
c59a0ec774
rustdoc: Move parse module to its own file
2012-01-16 01:07:41 -08:00
Brian Anderson
377316d8f6
rustdoc: Add parse::from_str for testing purposes
2012-01-16 01:07:41 -08:00
Brian Anderson
0e65ddfaea
rustdoc: Move AST parsing into the parse module
2012-01-16 01:07:41 -08:00
Brian Anderson
16462a77b0
build: Add rustdoc to tidy rules
2012-01-15 14:30:12 -08:00
Brian Anderson
66e97a9b08
rustdoc: Add a crate file
2012-01-15 14:30:12 -08:00
Brian Anderson
8f57be5bff
rustc: Rename mk_codemap_handler to mk_handler
2012-01-14 15:14:43 -08:00
Brian Anderson
e4849d5e5d
rustc: Allow a custom diagnostic emitter when building the handler
2012-01-14 15:14:43 -08:00
Brian Anderson
eb41fd9021
Update tools for new parser API
2012-01-13 22:07:55 -08:00
Marijn Haverbeke
d2be5b6c7a
Remove tests for objs, adjust tests that use objs
2012-01-13 11:52:13 +01:00
Marijn Haverbeke
34d7f05292
Major clean-up of std::io
...
Use ifaces instead of objs, stop wrapping everything in two (or three)
layers of no-value-added indirection, and remove some of the more
pointless/outdated idioms from the code.
2012-01-11 21:00:11 +01:00
Graydon Hoare
bfc9a499c2
Print usage messages to rustc and rustdoc when invoked with no args. Close #1394 .
2011-12-30 15:26:49 -08:00
Marijn Haverbeke
9587c67230
Fix rustdoc for AST changes
2011-12-22 22:16:02 +01:00
Elly Jones
c83cc5792f
rustdoc: Some rights reserved?
2011-12-20 17:19:46 -05:00
Elly Jones
00af3406fe
rustdoc: delete bogus license text
...
Rustdoc is under the same license as the rest of Rust, not under apache-2.0.
Signed-off-by: Elly Jones <elly@leptoquark.net>
2011-12-20 17:15:49 -05:00
Elly Jones
fb0896fe7b
rustdoc: Add.
...
Parses #[doc] attributes on top-level module items and generates Markdown.
Signed-off-by: Elly Jones <elly@leptoquark.net>
2011-12-20 16:52:04 -05:00