Opened at 2012-03-31T05:42:16Z

Closed at 2012-04-01T02:10:01Z

#1703 closed defect (fixed)

quickstart.rst: reflow to fill-column 77 and prepend utf-8 BOM

Reported by: zooko Owned by: zooko
Priority: normal Milestone: 1.9.2
Component: documentation Version: 1.9.1
Keywords: docs quickstart reviewed Cc:
Launchpad Bug:

Description

This patch applies on top of the patches from #1701 and #1702.

Attachments (1)

quickstart-reflow-and-utf8bom.diff.patch​ (5.1 KB) - added by zooko at 2012-03-31T05:42:22Z.

Download all attachments as: .zip

Change History (5)

Changed at 2012-03-31T05:42:22Z by zooko

comment:1 Changed at 2012-03-31T18:51:05Z by davidsarah

Wasn't there a problem with the trac not being able to render BOMs correctly? I remember you adding and removing BOMs quite a lot for other files, although I don't know what the ultimate conclusion about whether they should be there was.

comment:2 Changed at 2012-03-31T19:49:32Z by zooko

Yes, there's a bug in Trac -- ​http://trac.edgewall.org/ticket/10538 . It is fixed in Trac trunk. We can work-around it by having two blank lines between the utf-8 BOM and the restructuredtext header, which is what I've been doing,

comment:3 Changed at 2012-03-31T20:36:12Z by davidsarah

  • Keywords docs quickstart reviewed added; review-needed removed
  • Milestone changed from undecided to 1.9.2
  • Owner changed from somebody to zooko

+1

comment:4 Changed at 2012-04-01T02:10:01Z by zooko@…

  • Resolution set to fixed
  • Status changed from new to closed

In 638dcf867aaf1eb2:

docs: quickstart: edits

  • use out-of-line links to avoid a warning from rst2html --verbose (fixes #1704)
  • reflow to 77 fill-column and prepend utf-8 BOM (fixes #1703)
  • recommend Python 2.7 (fixes #1702)
  • remove link to wiki:AdvancedInstall (fixes #1701)
Note: See TracTickets for help on using tickets.