[ python-Bugs-1743846 ] Examples dropped from PDF version of docs

[SourceForge.net]

Bugs item #1743846, was opened at 2007-06-26 20:20
Message generated for change (Comment added) made by tcarroll
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1743846&group_id=5470

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation
Group: Python 2.5
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Terry Carroll (tcarroll)
Assigned to: Nobody/Anonymous (nobody)
Summary: Examples dropped from PDF version of docs

Initial Comment:
In section 13.13 of the PDF version Python Library Reference (on SQLite), a number of examples are dropped and instead have what looks like a statement that should have had the examples imported.

The HTML pages look fine, however.

For example, in section 13.13.3, in the PDF file it reads:

"""
This example shows how to use parameters with qmark style:
 1.py
This example shows how to use the named style:
 2.py
"""

In the HTML, it reads, correctly:

"""
This example shows how to use parameters with qmark style:

  import sqlite3

  con = sqlite3.connect("mydb")

  cur = con.cursor()

  who = "Yeltsin"
  age = 72

  cur.execute("select name_last, age from people where name_last=? and age=?", (who, age))
  print cur.fetchone()

  Download as text (original file name: sqlite3/execute_1.py).

This example shows how to use the named style:

  import sqlite3

  con = sqlite3.connect("mydb")

  cur = con.cursor()

  who = "Yeltsin"
  age = 72

  cur.execute("select name_last, age from people where name_last=:who and age=:age",
    {"who": who, "age": age})
  print cur.fetchone()

  Download as text (original file name: sqlite3/execute_2.py). 

"""

I've only looked at Chapter 13.13 (because I'm starting to use SQLite) and have found this in the following sections:

 13.13.1 (under complete_statement)
 13.13.2 (under row_factory and text_factory)
 13.13.3 (4 instances)
 13.13.4 (5 instances)
 13.13.6 (1 instance)

I'm attaching PDFs of the start of section 13.13.3 for comparison purposes: one copy from the PDF from http://docs.python.org/ftp/python/doc/2.5/pdf-letter-2.5.zip and one copy from the HTML at http://docs.python.org/lib/sqlite3-Cursor-Objects.html



----------------------------------------------------------------------

>Comment By: Terry Carroll (tcarroll)
Date: 2007-06-26 20:31

Message:
Logged In: YES 
user_id=755895
Originator: YES

Just a little bit more info: this also is present in the A4-version of the
PDF (i.e., both PDF version), as well as both the US-Letter and A4 versions
of the Postscript.  The HTML ZIP file appears okay.  I don't have LaTeX
installed and have no way of checking that one.

----------------------------------------------------------------------

Comment By: Terry Carroll (tcarroll)
Date: 2007-06-26 20:21

Message:
Logged In: YES 
user_id=755895
Originator: YES

Adding copy from HTML version,illustrating how it should look.
File Added: Lib-13-13-3-HTML.pdf

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1743846&group_id=5470