Commit Graph

480 Commits

Author SHA1 Message Date
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