Commit Graph

296 Commits

Author SHA1 Message Date
Brian Anderson
d3aa174846 rustdoc: Add definition of iface docs 2012-01-30 19:37:32 -08:00
Brian Anderson
fe745f1b5d rustdoc: Use fewer unique pointers 2012-01-30 13:05:25 -08:00
Brian Anderson
361f90e618 rustdoc: Sort the items so modules are printed last 2012-01-29 14:51:09 -08:00
Brian Anderson
07ac2e1043 rustdoc: Add a sorting pass 2012-01-29 14:15:14 -08:00
Brian Anderson
55e69eb458 rustdoc: Extract method to get item names 2012-01-29 13:36:54 -08:00
Brian Anderson
dbe2928c4d rustdoc: Fix typo in attr_pass 2012-01-29 13:25:38 -08:00
Brian Anderson
f8c93bdbe1 rustdoc: Move mod docs into the item tag 2012-01-29 13:08:18 -08:00
Brian Anderson
9732e0d554 rustdoc: Move fn docs into the item tag 2012-01-29 12:47:06 -08:00
Brian Anderson
5aa6c3a49a rustdoc: Move const docs into the item tag 2012-01-29 12:46:26 -08:00
Brian Anderson
95e2b1b8f9 rustdoc: Add test that unexported resources are pruned 2012-01-29 11:38:44 -08:00
Brian Anderson
d56a4dd04b rustdoc: Move enum docs into the item tag 2012-01-29 11:38:44 -08:00
Brian Anderson
40cbc89b6f rustdoc: Move resource docs into the item tag 2012-01-29 11:38:44 -08:00
Brian Anderson
bfd8a14065 rustdoc: Create an item tag to hold doc for all item types 2012-01-29 11:38:44 -08:00
Brian Anderson
7b67e2d274 rustdoc: Write both crates and mods as header level 1 2012-01-26 23:16:42 -08:00
Brian Anderson
094f91b685 rustdoc: Write markdown for resources 2012-01-26 22:54:20 -08:00
Brian Anderson
ca0aefa8bf rustdoc: Add resource arg tys to doc tree 2012-01-26 22:54:16 -08:00
Brian Anderson
e51ae23317 rustdoc: Apply generic string-op passes to resources 2012-01-26 22:27:13 -08:00
Brian Anderson
4c188fb82f rustdoc: Promote resource long descriptions to brief descriptions 2012-01-26 22:19:47 -08:00
Brian Anderson
21fc2a36d8 rustdoc: Build resource arguments as well 2012-01-26 22:14:16 -08:00
Brian Anderson
06ab83de2c rustdoc: Prune undocumented resources 2012-01-26 22:07:14 -08:00
Brian Anderson
ce7d150493 rustdoc: Add resource attribute docs to the doc tree 2012-01-26 21:39:20 -08:00
Brian Anderson
2efc6004b5 rustdoc: Parse resource doc attributes 2012-01-26 21:20:17 -08:00
Brian Anderson
97a1110c5f rustdoc: Add resource signatures to doc tree 2012-01-26 20:59:15 -08:00
Brian Anderson
e44467a47f rustdoc: Add resources to the doc fold 2012-01-26 20:34:16 -08:00
Brian Anderson
23e9f7a1b6 rustdoc: Extract resources from the AST 2012-01-26 20:34:16 -08:00
Brian Anderson
7cf725355a rustdoc: Add a resource node to the doc tree 2012-01-26 20:34:16 -08:00
Brian Anderson
a06850c8aa rustdoc: Prune unexported enums and variants 2012-01-26 17:29:55 -08:00
Brian Anderson
28fbb19664 rustc: Switch the --no-core switch to a #[no_core] attribute 2012-01-26 16:43:33 -08:00
Brian Anderson
91ee6afeae rustdoc: Set up the compiler session properly in prep for running resolve 2012-01-26 11:36:29 -08:00
Brian Anderson
38908581f7 rustdoc: Rename astsrv::ctxt.map to ast_map 2012-01-26 11:05:21 -08:00
Brian Anderson
566a4be1f8 rustdoc: Add some test enums to demo module 2012-01-25 21:04:53 -08:00
Brian Anderson
74e8b11194 rustdoc: Write markdown for enums 2012-01-25 21:04:53 -08:00
Brian Anderson
d6ce20973a rustdoc: Apply general string ops to enum docs 2012-01-25 21:04:53 -08:00
Brian Anderson
53c6454de5 rustdoc: Extract brief enum descs from long descs 2012-01-25 21:04:53 -08:00
Brian Anderson
1d94f40c6c rustdoc: Prune undocumented enums 2012-01-25 21:04:53 -08:00
Brian Anderson
95a006ce52 rustdoc: Add enum doc attributes to the doc tree 2012-01-25 21:04:53 -08:00
Brian Anderson
a25bc195e2 rustdoc: Parse variant doc attributes 2012-01-25 21:04:53 -08:00
Brian Anderson
87c3a5c1a3 rustdoc: Extract some common functions from attr_parser 2012-01-25 21:04:52 -08:00
Brian Anderson
259ea4e4b4 rustdoc: Parse enum doc attributes 2012-01-25 21:04:52 -08:00
Brian Anderson
5166cc29e9 rustdoc: Fix a copy&paste bug in attr_parser tests 2012-01-25 21:04:52 -08:00
Brian Anderson
0b9f2a8215 rustdoc: Extract variant signatures 2012-01-25 21:04:49 -08:00
Brian Anderson
1586cce0ea rustdoc: Add enum folding 2012-01-25 16:56:28 -08:00
Brian Anderson
e946792a78 rustdoc: Extract enum doc nodes from AST nodes 2012-01-25 16:50:32 -08:00
Kevin Atkinson
c5e03e0e59 Keep source file around after parsing.
Specifically box the string (to avoid unnecessary copies) and store it
in codemap::filemap.

Remove the hack in driver::diagnostic that rereads the source from the
file and instead just get the source from the filemap.

(This commit is also a prerequisite for issue #1612)
2012-01-25 16:00:47 -07:00
Brian Anderson
61b5cc95d1 rustdoc: Add enums to the doc tree 2012-01-24 23:24:55 -08:00
Brian Anderson
b779277dae rustdoc: Add a pass to normalize indentation levels in doc comments 2012-01-24 23:24:54 -08:00
Brian Anderson
e869458914 rustdoc: Extract a general apply-function-to-strings pass from trim_pass 2012-01-24 23:24:54 -08:00
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