From a1da7dbca35251e05dab0901d1f3b104fa2f8f04 Mon Sep 17 00:00:00 2001
From: "yusuke.shinyama.dummy"
 <yusuke.shinyama.dummy@1aa58f4a-7d42-0410-adbc-911cccaed67c>
Date: Sat, 29 May 2010 11:51:24 +0000
Subject: [PATCH] update usage document

git-svn-id: https://pdfminerr.googlecode.com/svn/trunk/pdfminer@219 1aa58f4a-7d42-0410-adbc-911cccaed67c
---
 docs/layout.obj | 389 ++++++++++++++++++++++++++++++++++++++++++++++++
 docs/layout.png | Bin 0 -> 3607 bytes
 docs/usage.html | 101 ++++++++++---
 3 files changed, 468 insertions(+), 22 deletions(-)
 create mode 100644 docs/layout.obj
 create mode 100644 docs/layout.png

diff --git a/docs/layout.obj b/docs/layout.obj
new file mode 100644
index 0000000..c046ec6
--- /dev/null
+++ b/docs/layout.obj
@@ -0,0 +1,389 @@
+%TGIF 4.1.45-QPL
+state(0,37,100.000,0,0,0,16,1,9,1,1,0,0,0,0,1,1,'Helvetica-Bold',1,69120,0,0,1,5,0,0,1,1,0,16,0,0,1,1,1,1,1050,1485,1,0,2880,0).
+%
+% @(#)$Header$
+% %W%
+%
+unit("1 pixel/pixel").
+color_info(19,65535,0,[
+	"magenta", 65535, 0, 65535, 65535, 0, 65535, 1,
+	"red", 65535, 0, 0, 65535, 0, 0, 1,
+	"green", 0, 65535, 0, 0, 65535, 0, 1,
+	"blue", 0, 0, 65535, 0, 0, 65535, 1,
+	"yellow", 65535, 65535, 0, 65535, 65535, 0, 1,
+	"pink", 65535, 49344, 52171, 65535, 49344, 52171, 1,
+	"cyan", 0, 65535, 65535, 0, 65535, 65535, 1,
+	"CadetBlue", 24415, 40606, 41120, 24415, 40606, 41120, 1,
+	"white", 65535, 65535, 65535, 65535, 65535, 65535, 1,
+	"black", 0, 0, 0, 0, 0, 0, 1,
+	"DarkSlateGray", 12079, 20303, 20303, 12079, 20303, 20303, 1,
+	"#00000000c000", 0, 0, 49344, 0, 0, 49152, 1,
+	"#820782070000", 33410, 33410, 0, 33287, 33287, 0, 1,
+	"#3cf3fbee34d2", 15420, 64507, 13364, 15603, 64494, 13522, 1,
+	"#3cf3fbed34d3", 15420, 64507, 13364, 15603, 64493, 13523, 1,
+	"#ffffa6990000", 65535, 42662, 0, 65535, 42649, 0, 1,
+	"#ffff0000fffe", 65535, 0, 65535, 65535, 0, 65534, 1,
+	"#fffe0000fffe", 65535, 0, 65535, 65534, 0, 65534, 1,
+	"#fffe00000000", 65535, 0, 0, 65534, 0, 0, 1
+]).
+script_frac("0.6").
+fg_bg_colors('black','white').
+dont_reencode("FFDingbests:ZapfDingbats").
+objshadow_info('#c0c0c0',2,2).
+page(1,"",1,'').
+box('black','',50,45,300,355,2,2,1,0,0,0,0,0,0,'2',0,[
+]).
+box('black','',75,75,195,225,2,1,1,10,8,0,0,0,0,'1',0,[
+]).
+box('black','',85,105,185,125,2,1,1,18,8,0,0,0,0,'1',0,[
+]).
+box('black','',85,105,105,125,2,1,1,19,0,0,0,0,0,'1',0,[
+]).
+box('black','',105,105,125,125,2,1,1,20,0,0,0,0,0,'1',0,[
+]).
+text('black',95,108,1,1,1,9,15,21,12,3,0,0,0,0,2,9,15,0,0,"",0,0,0,0,120,'',[
+minilines(9,15,0,0,1,0,0,[
+mini_line(9,12,3,0,0,0,[
+str_block(0,9,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica',0,69120,9,12,3,0,-1,0,0,0,0,0,
+	"A")])
+])
+])]).
+text('black',115,108,1,1,1,8,15,28,12,3,0,0,0,0,2,8,15,0,0,"",0,0,0,0,120,'',[
+minilines(8,15,0,0,1,0,0,[
+mini_line(8,12,3,0,0,0,[
+str_block(0,8,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica',0,69120,8,12,3,0,-1,0,0,0,0,0,
+	"B")])
+])
+])]).
+box('black','',125,105,145,125,0,1,1,32,0,0,0,0,0,'1',0,[
+]).
+text('black',135,108,1,1,1,9,15,36,12,3,0,0,0,0,2,9,15,0,0,"",0,0,0,0,120,'',[
+minilines(9,15,0,0,1,0,0,[
+mini_line(9,12,3,0,0,0,[
+str_block(0,9,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica',0,69120,9,12,3,0,-1,0,0,0,0,0,
+	"C")])
+])
+])]).
+poly('black','',2,[
+	215,140,215,220],0,3,1,51,0,0,0,0,0,0,0,'3',0,0,
+    "0","",[
+    0,12,5,0,'12','5','0'],[0,12,5,0,'12','5','0'],[
+]).
+box('black','',175,265,270,325,0,3,1,65,0,0,0,0,0,'3',0,[
+]).
+box('black','',185,270,260,320,0,1,1,69,8,0,0,0,0,'1',0,[
+]).
+poly('black','',6,[
+	195,295,215,290,235,310,245,285,225,300,195,295],0,2,1,74,0,0,0,0,0,0,0,'2',0,0,
+    "00","",[
+    0,10,4,0,'10','4','0'],[0,10,4,0,'10','4','0'],[
+]).
+box('black','',85,275,140,315,1,2,0,87,0,0,0,0,0,'2',0,[
+]).
+text('black',85,23,1,1,1,44,15,93,12,3,0,0,0,0,2,44,15,0,0,"",0,0,0,0,35,'',[
+minilines(44,15,0,0,1,0,0,[
+mini_line(44,12,3,0,0,0,[
+str_block(0,44,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,44,12,3,0,-1,0,0,0,0,0,
+	"LTPage")])
+])
+])]).
+text('black',255,133,1,1,1,39,15,100,12,3,0,0,0,0,2,39,15,0,0,"",0,0,0,0,145,'',[
+minilines(39,15,0,0,1,0,0,[
+mini_line(39,12,3,0,0,0,[
+str_block(0,39,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,39,12,3,0,-1,0,0,0,0,0,
+	"LTLine")])
+])
+])]).
+text('black',125,83,1,1,1,42,15,104,12,3,0,0,0,0,2,42,15,0,0,"",0,0,0,0,95,'',[
+minilines(42,15,0,0,1,0,0,[
+mini_line(42,12,3,0,0,0,[
+str_block(0,42,12,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,42,12,3,0,0,0,0,0,0,0,
+	"LTChar")])
+])
+])]).
+text('black',245,53,1,1,1,65,15,108,12,3,0,0,0,0,2,65,15,0,0,"",0,0,0,0,65,'',[
+minilines(65,15,0,0,1,0,0,[
+mini_line(65,12,3,0,0,0,[
+str_block(0,65,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,65,12,3,0,-1,0,0,0,0,0,
+	"LTTextBox")])
+])
+])]).
+text('black',245,88,1,1,1,66,15,110,12,3,0,0,0,0,2,66,15,0,0,"",0,0,0,0,100,'',[
+minilines(66,15,0,0,1,0,0,[
+mini_line(66,12,3,0,0,0,[
+str_block(0,66,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,66,12,3,0,-1,0,0,0,0,0,
+	"LTTextLine")])
+])
+])]).
+text('black',255,243,1,1,1,51,15,112,12,3,0,0,0,0,2,51,15,0,0,"",0,0,0,0,255,'',[
+minilines(51,15,0,0,1,0,0,[
+mini_line(51,12,3,0,0,0,[
+str_block(0,51,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,51,12,3,0,-1,0,0,0,0,0,
+	"LTFigure")])
+])
+])]).
+text('black',140,243,1,1,1,51,15,114,12,3,0,0,0,0,2,51,15,0,0,"",0,0,0,0,255,'',[
+minilines(51,15,0,0,1,0,0,[
+mini_line(51,12,3,0,0,0,[
+str_block(0,51,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,51,12,3,0,-1,0,0,0,0,0,
+	"LTImage")])
+])
+])]).
+text('black',240,223,1,1,1,43,15,116,12,3,0,0,0,0,2,43,15,0,0,"",0,0,0,0,235,'',[
+minilines(43,15,0,0,1,0,0,[
+mini_line(43,12,3,0,0,0,[
+str_block(0,43,12,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,43,12,3,0,0,0,0,0,0,0,
+	"LTRect")])
+])
+])]).
+text('black',190,333,1,1,1,62,15,118,12,3,0,0,0,0,2,62,15,0,0,"",0,0,0,0,345,'',[
+minilines(62,15,0,0,1,0,0,[
+mini_line(62,12,3,0,0,0,[
+str_block(0,62,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,62,12,3,0,-1,0,0,0,0,0,
+	"LTPolygon")])
+])
+])]).
+text('black',170,138,1,1,1,42,15,121,12,3,0,0,0,0,2,42,15,0,0,"",0,0,0,0,150,'',[
+minilines(42,15,0,0,1,0,0,[
+mini_line(42,12,3,0,0,0,[
+str_block(0,42,12,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,42,12,3,0,0,0,0,0,0,0,
+	"LTText")])
+])
+])]).
+box('black','',145,105,165,125,0,1,1,125,8,0,0,0,0,'1',0,[
+]).
+poly('black','',2,[
+	105,95,95,110],0,1,1,135,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	165,140,155,115],0,1,1,138,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	215,65,190,80],0,1,1,139,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	215,100,180,115],0,1,1,140,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	235,140,215,150],0,1,1,141,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	220,235,205,265],0,1,1,146,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	235,255,225,275],0,1,1,147,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	195,330,220,300],0,1,1,148,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	125,255,110,280],0,1,1,149,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+text('black',610,33,1,1,1,44,15,151,12,3,0,0,0,0,2,44,15,0,0,"",0,0,0,0,45,'',[
+minilines(44,15,0,0,1,0,0,[
+mini_line(44,12,3,0,0,0,[
+str_block(0,44,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,44,12,3,0,-1,0,0,0,0,0,
+	"LTPage")])
+])
+])]).
+text('black',460,108,1,1,1,65,15,152,12,3,0,0,0,0,2,65,15,0,0,"",0,0,0,0,120,'',[
+minilines(65,15,0,0,1,0,0,[
+mini_line(65,12,3,0,0,0,[
+str_block(0,65,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,65,12,3,0,-1,0,0,0,0,0,
+	"LTTextBox")])
+])
+])]).
+text('black',410,178,1,1,1,66,15,154,12,3,0,0,0,0,2,66,15,0,0,"",0,0,0,0,190,'',[
+minilines(66,15,0,0,1,0,0,[
+mini_line(66,12,3,0,0,0,[
+str_block(0,66,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,66,12,3,0,-1,0,0,0,0,0,
+	"LTTextLine")])
+])
+])]).
+text('black',360,248,1,1,1,42,15,157,12,3,0,0,0,0,2,42,15,0,0,"",0,0,0,0,260,'',[
+minilines(42,15,0,0,1,0,0,[
+mini_line(42,12,3,0,0,0,[
+str_block(0,42,12,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,42,12,3,0,0,0,0,0,0,0,
+	"LTChar")])
+])
+])]).
+text('black',420,248,1,1,1,42,15,159,12,3,0,0,0,0,2,42,15,0,0,"",0,0,0,0,260,'',[
+minilines(42,15,0,0,1,0,0,[
+mini_line(42,12,3,0,0,0,[
+str_block(0,42,12,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,42,12,3,0,0,0,0,0,0,0,
+	"LTChar")])
+])
+])]).
+text('black',480,248,1,1,1,42,15,161,12,3,0,0,0,0,2,42,15,0,0,"",0,0,0,0,260,'',[
+minilines(42,15,0,0,1,0,0,[
+mini_line(42,12,3,0,0,0,[
+str_block(0,42,12,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,42,12,3,0,0,0,0,0,0,0,
+	"LTText")])
+])
+])]).
+text('black',460,178,1,1,1,12,15,170,12,3,0,0,0,0,2,12,15,0,0,"",0,0,0,0,190,'',[
+minilines(12,15,0,0,1,0,0,[
+mini_line(12,12,3,0,0,0,[
+str_block(0,12,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,12,12,3,0,-1,0,0,0,0,0,
+	"...")])
+])
+])]).
+text('black',520,248,1,1,1,12,15,172,12,3,0,0,0,0,2,12,15,0,0,"",0,0,0,0,260,'',[
+minilines(12,15,0,0,1,0,0,[
+mini_line(12,12,3,0,0,0,[
+str_block(0,12,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,12,12,3,0,-1,0,0,0,0,0,
+	"...")])
+])
+])]).
+text('black',560,108,1,1,1,51,15,174,12,3,0,0,0,0,2,51,15,0,0,"",0,0,0,0,120,'',[
+minilines(51,15,0,0,1,0,0,[
+mini_line(51,12,3,0,0,0,[
+str_block(0,51,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,51,12,3,0,-1,0,0,0,0,0,
+	"LTFigure")])
+])
+])]).
+text('black',635,108,1,1,1,39,15,178,12,3,0,0,0,0,2,39,15,0,0,"",0,0,0,0,120,'',[
+minilines(39,15,0,0,1,0,0,[
+mini_line(39,12,3,0,0,0,[
+str_block(0,39,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,39,12,3,0,-1,0,0,0,0,0,
+	"LTLine")])
+])
+])]).
+text('black',700,108,1,1,1,43,15,180,12,3,0,0,0,0,2,43,15,0,0,"",0,0,0,0,120,'',[
+minilines(43,15,0,0,1,0,0,[
+mini_line(43,12,3,0,0,0,[
+str_block(0,43,12,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,43,12,3,0,0,0,0,0,0,0,
+	"LTRect")])
+])
+])]).
+text('black',580,178,1,1,1,62,15,182,12,3,0,0,0,0,2,62,15,0,0,"",0,0,0,0,190,'',[
+minilines(62,15,0,0,1,0,0,[
+mini_line(62,12,3,0,0,0,[
+str_block(0,62,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,62,12,3,0,-1,0,0,0,0,0,
+	"LTPolygon")])
+])
+])]).
+text('black',775,108,1,1,1,51,15,186,12,3,0,0,0,0,2,51,15,0,0,"",0,0,0,0,120,'',[
+minilines(51,15,0,0,1,0,0,[
+mini_line(51,12,3,0,0,0,[
+str_block(0,51,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,51,12,3,0,-1,0,0,0,0,0,
+	"LTImage")])
+])
+])]).
+poly('black','',2,[
+	475,105,590,50],0,1,1,190,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	560,110,595,50],0,1,1,191,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	635,105,600,50],0,1,1,192,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	610,50,700,100],0,1,1,193,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	765,100,630,50],0,1,1,194,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	460,125,425,175],0,1,1,196,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	560,125,570,175],0,1,1,197,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	415,195,370,245],0,1,1,198,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	415,195,420,245],0,1,1,199,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	415,195,475,245],0,1,1,200,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	470,125,485,175],0,1,1,206,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	420,195,510,220],0,1,1,207,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',2,[
+	565,125,635,175],0,1,1,208,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+text('black',635,178,1,1,1,12,15,215,12,3,0,0,0,0,2,12,15,0,0,"",0,0,0,0,190,'',[
+minilines(12,15,0,0,1,0,0,[
+mini_line(12,12,3,0,0,0,[
+str_block(0,12,12,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,69120,12,12,3,0,-1,0,0,0,0,0,
+	"...")])
+])
+])]).
diff --git a/docs/layout.png b/docs/layout.png
new file mode 100644
index 0000000000000000000000000000000000000000..3b06490ba00efe35cfa599df0f4ff3b0aa008d88
GIT binary patch
literal 3607
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
X9h+p2=;N(^cyji~oR7Y@xp?<~&+MLx

literal 0
HcmV?d00001

diff --git a/docs/usage.html b/docs/usage.html
index 6d1cdf5..bb7f704 100644
--- a/docs/usage.html
+++ b/docs/usage.html
@@ -2,16 +2,18 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
-<title>PDFMiner Development Guide</title>
+<title>Programming with PDFMiner</title>
 <style type="text/css"><!--
 blockquote { background: #eeeeee; }
 .comment { color: darkgreen; }
 --></style>
 </head><body>
-
-<h1>PDFMiner Development Guide</h1>
 <p>
-This document describes how to use PDFMiner as a library 
+<a href="index.html">[Back to PDFMiner]</a>
+
+<h1>Programming with PDFMiner</h1>
+<p>
+This document explains how to use PDFMiner as a library 
 from other applications.
 <ul>
 <li> <a href="#basic">Basic Usage</a>
@@ -59,7 +61,7 @@ for page in doc.get_pages():
 In PDFMiner, there are several Python classes involved in parsing a PDF file,
 as shown in Figure 1.
 
-<div>
+<div align=center>
 <img src="objrel.png"><br>
 <small>Figure 1. Relationships between PDFMiner objects</small>
 </div>
@@ -70,11 +72,10 @@ as shown in Figure 1.
 <p>
 PDF documents are more like graphics, rather than text documents.
 It presents no logical structure such as sentences or paragraphs (for most cases).
-PDFMiner tries to reconstruct the original structure by performing
+PDFMiner attempts to reconstruct some of these structures by performing
 basic layout analysis.
 <p>
-
-
+Here is a typical way to do it:
 <blockquote><pre>
 from pdfminer.layout import LAParams
 from pdfminer.converter import PDFPageAggregator
@@ -86,40 +87,96 @@ device = PDFPageAggregator(rsrcmgr, laparams=laparams)
 interpreter = PDFPageInterpreter(rsrcmgr, device)
 for page in doc.get_pages():
     interpreter.process_page(page)
-    <span class="comment"># receive the top-level layout object.</span>
-    ltpage = device.get_result()
+    <span class="comment"># receive the LTPage object for the page.</span>
+    layout = device.get_result()
 </pre></blockquote>
 
-<ul>
-<li> <code>LTPage</code>
-<li> <code>LTTextBox</code>
-<li> <code>LTTextLine</code>
-<li> <code>LTChar</code>
-<li> <code>LTText</code>
-<li> <code>LTFigure</code>
-<li> <code>LTImage</code>
-<li> <code>LTRect</code>
-<li> <code>LTPolygon</code>
-<li> <code>LTLine</code>
-</ul>
+The layout analyzer gives a "<code>LTPage</code>" object for each page
+in the PDF document. The object contains child objects within the page,
+forming a tree-like structure. Figure 2 shows the relationship between
+these objects.
+
+<div align=center>
+<img src="layout.png"><br>
+<small>Figure 2. Layout objects and its tree structure</small>
+</div>
+
+<dl>
+<dt> <code>LTPage</code>
+<dd> Represents an entire page. May contain child objects like
+<code>LTTextBox</code>, <code>LTFigure</code>, <code>LTImage</code>, <code>LTRect</code>, 
+<code>LTPolygon</code> and <code>LTLine</code>.
+
+<dt> <code>LTTextBox</code>
+<dd> Represents a group of text chunks that can be contained in a rectangular area.
+Note that this box is created by geometric analysis and does not necessarily
+represents a logical boundary of the text. 
+It contains a list of <code>LTTextLine</code> objects.
+
+<dt> <code>LTTextLine</code>
+<dd> Contains a list of <code>LTChar</code> objects that represent
+a single text line. The characters are aligned either horizontaly
+or vertically, depending on the text's writing mode.
+
+<dt> <code>LTChar</code>
+<dt> <code>LTText</code>
+<dd> These objects represent an actual letter in the text as a Unicode string.
+Note that, while a <code>LTChar</code> object has actual boundaries,
+<code>LTText</code> objects does not, as these are "virtual" characters,
+inserted by a layout analyzer according to the relationship between two characters
+(e.g. a space).
+
+<dt> <code>LTFigure</code>
+<dd> Represents an area used by PDF Form objects. PDF Forms can be used to
+present figures or pictures by embedding yet another PDF document within a page.
+Note that <code>LTFigure</code> objects can appear recursively.
+
+<dt> <code>LTImage</code>
+<dd> Represents an image object. Embedded images can be 
+in JPEG or other formats, but currently PDFMiner does not 
+pay much attention to graphical objects.
+
+<dt> <code>LTLine</code>
+<dd> Represents a single straight line shown in a page. 
+Could be used for separating texts or figures.
+
+<dt> <code>LTRect</code>
+<dd> Represents a rectangle shown in a page. 
+Could be used for framing another pictures or figures.
+
+<dt> <code>LTPolygon</code>
+<dd> Represents a polygon in a page. 
+</dl>
 
 <a name="toc">
 <hr noshade>
 <h2>TOC Extraction</h2>
+<p>
+PDFMiner provides functions to access the document's table of contents
+("Outlines").
 
 <blockquote><pre>
+from pdfminer.pdfparser import PDFParser, PDFDocument
+
 fp = open('mypdf.pdf', 'rb')
 parser = PDFParser(fp)
 doc = PDFDocument()
 parser.set_document(doc)
 doc.set_parser(parser)
 doc.initialize(password)
+
 <span class="comment"># Get the outlines of the document.</span>
 outlines = doc.get_outlines()
 for (level,title,dest,a,se) in outlines:
     print (level, title)
 </pre></blockquote>
 
+<p>
+In some PDF documents, destinations are referred to as page numbers.
+In other PDF documents, destinations are referred to as page numbers plus
+the location within the page. Since PDF does not provide a way to
+point to graphical objects in a page, normally these in-page destinations
+are specified by physical coordinates.
 
 <hr noshade>
 <address>Yusuke Shinyama</address>