Skip to content

Commit

Permalink
Standardize bibliographic citations in rustc API docs
Browse files Browse the repository at this point in the history
  • Loading branch information
pierwill committed Jul 3, 2020
1 parent 0ca7f74 commit bdc1f40
Show file tree
Hide file tree
Showing 3 changed files with 14 additions and 16 deletions.
10 changes: 4 additions & 6 deletions src/librustc_ast_pretty/pp.rs
Original file line number Diff line number Diff line change
@@ -1,10 +1,8 @@
//! This pretty-printer is a direct reimplementation of Philip Karlton's
//! Mesa pretty-printer, as described in appendix A of
//!
//! ```text
//! STAN-CS-79-770: "Pretty Printing", by Derek C. Oppen.
//! Stanford Department of Computer Science, 1979.
//! ```
//! Mesa pretty-printer, as described in the appendix to
//! Derek C. Oppen, "Pretty Printing" (1979),
//! Stanford Computer Science Department STAN-CS-79-770,
//! <http://i.stanford.edu/pub/cstr/reports/cs/tr/79/770/CS-TR-79-770.pdf>.
//!
//! The algorithm's aim is to break a stream into as few lines as possible
//! while respecting the indentation-consistency requirements of the enclosing
Expand Down
11 changes: 6 additions & 5 deletions src/librustc_data_structures/graph/dominators/mod.rs
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
//! Algorithm citation:
//! A Simple, Fast Dominance Algorithm.
//! Keith D. Cooper, Timothy J. Harvey, and Ken Kennedy
//! Rice Computer Science TS-06-33870
//! <https://www.cs.rice.edu/~keith/EMBED/dom.pdf>
//! Finding the dominators in a control-flow graph.
//!
//! Algorithm based on Keith D. Cooper, Timothy J. Harvey, and Ken Kennedy,
//! "A Simple, Fast Dominance Algorithm",
//! Rice Computer Science TS-06-33870,
//! <https://www.cs.rice.edu/~keith/EMBED/dom.pdf>.
use super::iterate::reverse_post_order;
use super::ControlFlowGraph;
Expand Down
9 changes: 4 additions & 5 deletions src/librustc_span/hygiene.rs
Original file line number Diff line number Diff line change
@@ -1,9 +1,8 @@
//! Machinery for hygienic macros, inspired by the `MTWT[1]` paper.
//! Machinery for hygienic macros.
//!
//! `[1]` Matthew Flatt, Ryan Culpepper, David Darais, and Robert Bruce Findler. 2012.
//! *Macros that work together: Compile-time bindings, partial expansion,
//! and definition contexts*. J. Funct. Program. 22, 2 (March 2012), 181-216.
//! DOI=10.1017/S0956796812000093 <https://doi.org/10.1017/S0956796812000093>
//! Inspired by Matthew Flatt et al., “Macros That Work Together: Compile-Time Bindings, Partial
//! Expansion, and Definition Contexts,” *Journal of Functional Programming* 22, no. 2
//! (March 1, 2012): 181–216, <https://doi.org/10.1017/S0956796812000093>.
// Hygiene data is stored in a global variable and accessed via TLS, which
// means that accesses are somewhat expensive. (`HygieneData::with`
Expand Down

0 comments on commit bdc1f40

Please sign in to comment.