Index: /trunk/cli/dune
===================================================================
--- /trunk/cli/dune	(revision 8)
+++ /trunk/cli/dune	(revision 9)
@@ -2,4 +2,4 @@
  (name txt)
  (public_name txt)
- (modules txt authors convert conversion file index last listing new topics html atom gemini publish pull)
+ (modules txt authors convert conversion file index last listing new topics html atom gemini publish pull read)
  (libraries text_parse.converter text_parse.parsers logarion msgpck curl str cmdliner))
Index: /trunk/cli/listing.ml
===================================================================
--- /trunk/cli/listing.ml	(revision 8)
+++ /trunk/cli/listing.ml	(revision 9)
@@ -2,29 +2,27 @@
 module FS = File_store
 module A = Archive
-let listing r order_opt reverse_opt number_opt authors_opt topics_opt =
-	let predicates = A.predicate A.authored authors_opt
-		@ A.predicate A.topics topics_opt in
+
+let listing r order_opt reverse_opt number_opt paths_opt authors_opt topics_opt =
+	let predicates = A.predicate A.authored authors_opt @ A.predicate A.topics topics_opt in
 	let predicate text = List.fold_left (fun a e -> a && e text) true predicates in
-	let list_text a (t, fnames) = a ^ Printf.sprintf "%s %s %s 𐄁 %s [%s]\n"
+	let list_text (t, fnames) = Printf.printf "%s %s %s 𐄁 %s%s\n"
 		(Text.short_id t) Date.(pretty_date @@ listing t.Text.date)
 		(Person.Set.to_string ~names_only:true t.Text.authors)
-		t.Text.title (List.hd fnames)
+		t.Text.title (if paths_opt then (List.fold_left (Printf.sprintf "%s\n@ %s") "" fnames) else "")
 	in
-	print_string @@ match order_opt with
-	| false -> FS.fold ~r ~predicate list_text ""
+	match order_opt with
+	| false -> FS.iter ~r ~predicate list_text
 	| true ->
 		let order = match reverse_opt with true -> FS.newest | false -> FS.oldest in
 		match number_opt with
-		| Some number -> FS.fold ~r ~predicate ~order ~number list_text ""
-		| None -> FS.fold ~r ~predicate ~order list_text ""
+		| Some number -> FS.iter ~r ~predicate ~order ~number list_text
+		| None -> FS.iter ~r ~predicate ~order list_text
 
 open Cmdliner
 let term =
-	let recurse = Arg.(value & flag & info ["R"]
-		~doc:"recursive, include texts in subdirectories too") in
-	let reverse = Arg.(value & flag & info ["r"]
-		~doc:"reverse order") in
-	let time   = Arg.(value & flag & info ["t"]
-		~doc:"Sort by time, newest first") in
+	let recurse = Arg.(value & flag & info ["R"] ~doc:"recurse, include subdirs") in
+	let reverse = Arg.(value & flag & info ["r"] ~doc:"reverse order") in
+	let time   = Arg.(value & flag & info ["t"] ~doc:"sort by time, newest first") in
+	let paths = Arg.(value & flag & info ["p"] ~doc:"show file paths") in
 	let number = Arg.(value & opt (some int) None & info ["n"]
 		~docv:"number" ~doc:"number of entries to list") in
@@ -33,6 +31,6 @@
 	let topics = Arg.(value & opt (some string) None & info ["topics"]
 		~docv:"comma-separated topics" ~doc:"texts with topics") in
-	Term.(const listing $ recurse $ time $ reverse $ number $ authed $ topics),
+	Term.(const listing $ recurse $ time $ reverse $ number $ paths $ authed $ topics),
 	Term.info "list" ~doc:"list texts" ~man:[ `S "DESCRIPTION";
-	`P "List header information for current directory. If -R is used, list header
-	information for texts found in subdirectories too, along with their filepaths" ]
+		`P "List header information for current directory. If -R is used, list header
+		information for texts found in subdirectories too, along with their filepaths" ]
Index: /trunk/cli/read.ml
===================================================================
--- /trunk/cli/read.ml	(revision 9)
+++ /trunk/cli/read.ml	(revision 9)
@@ -0,0 +1,38 @@
+open Logarion
+module FS = File_store
+module A = Archive
+
+let print r order_opt reverse_opt number_opt authors_opt topics_opt id_opt =
+	let predicates = if id_opt <> "" then [ A.ided id_opt ] else []
+		@ A.predicate A.authored authors_opt
+		@ A.predicate A.topics topics_opt in
+	let predicate text = List.fold_left (fun a e -> a && e text) true predicates in
+	let pager = try Sys.getenv "PAGER" with Not_found -> "less" in
+	let print_text acc (_t, fnames) = Printf.sprintf "%s %s" acc (List.hd fnames) in
+	let paths = match order_opt with
+	| false -> FS.fold ~r ~predicate print_text ""
+	| true ->
+		let order = match reverse_opt with true -> FS.newest | false -> FS.oldest in
+		match number_opt with
+		| Some number -> FS.fold ~r ~predicate ~order ~number print_text ""
+		| None -> FS.fold ~r ~predicate ~order print_text ""
+	in if paths = "" then ()
+	else (ignore @@ Sys.command @@ Printf.sprintf "%s %s" pager paths)
+	
+
+open Cmdliner
+let term =
+	let id = Arg.(value & pos 0 string "" & info [] ~docv:"text ID") in
+	let recurse = Arg.(value & flag & info ["R"] ~doc:"recurse, include subdirs") in
+	let reverse = Arg.(value & flag & info ["r"] ~doc:"reverse order") in
+	let time   = Arg.(value & flag & info ["t"] ~doc:"sort by time, newest first") in
+	let number = Arg.(value & opt (some int) None & info ["n"]
+		~docv:"number" ~doc:"number of entries to list") in
+	let authed = Arg.(value & opt (some string) None & info ["authored"]
+		~docv:"comma-separated names" ~doc:"texts by authors") in
+	let topics = Arg.(value & opt (some string) None & info ["topics"]
+		~docv:"comma-separated topics" ~doc:"texts with topics") in
+	Term.(const print $ recurse $ time $ reverse $ number $ authed $ topics $ id),
+	Term.info "read" ~doc:"list texts" ~man:[ `S "DESCRIPTION";
+		`P "List header information for current directory. If -R is used, list header
+		information for texts found in subdirectories too, along with their filepaths" ]
Index: /trunk/cli/txt.ml
===================================================================
--- /trunk/cli/txt.ml	(revision 8)
+++ /trunk/cli/txt.ml	(revision 9)
@@ -17,4 +17,5 @@
 	Publish.term;
 	Pull.term;
+	Read.term;
 	Topics.term;
 	] with `Error _ -> exit 1 | _ -> exit 0
Index: /trunk/lib/archive.ml
===================================================================
--- /trunk/lib/archive.ml	(revision 8)
+++ /trunk/lib/archive.ml	(revision 9)
@@ -4,4 +4,7 @@
   let q = Person.Set.of_query @@ String_set.query query_string in
   fun n -> Person.Set.predicate q n.Text.authors
+
+let ided query_string =
+	fun n -> n.Text.id = query_string
 
 let keyworded query_string =
