/usr/local/poudriere/data/packages/e24a8cae34360705d022f17584bb6b4507b8eb89-build1/All/refdb-0.9.9_7.txz vs.
/usr/local/poudriere/data/packages/e24a8cae34360705d022f17584bb6b4507b8eb89-build2/All/refdb-0.9.9_7.txz
refdb-0.9.9_7.txz-content
+MANIFEST
Offset 1, 1 lines modifiedOffset 1, 1 lines modified
1 {"name":​"refdb",​"origin":​"textproc/​refdb",​"version":​"0.​9.​9_7",​"comment":​"Bibliographic·​reference·​database",​"maintainer":​"ohartman@zedat.​fu-​berlin.​de",​"www":​"http:​/​/​refdb.​sourceforge.​net/​",​"abi":​"FreeBSD:​11:​amd64",​"arch":​"freebsd:​11:​x86:​64",​"prefix":​"/​usr/​local",​"flatsize":​7434387,​"licenselogic":​"single",​"desc":​"RefDB·​is·​a·​client-​server·​database·​system·​for·​storing,​·​retrieving·​and\nformatting·​bibliographic·​references.​\n\nWWW:​·​http:​/​/​refdb.​sourceforge.​net/​",​"deps":​{"expat":​{"origin":​"textproc/​expat2",​"version":​"2.​1.​0_3"},​"btparse":​{"origin":​"textproc/​btparse",​"version":​"0.​35_1"},​"postgresql93-​client":​{"origin":​"databases/​postgresql93-​client",​"version":​"9.​3.​13"},​"readline":​{"origin":​"devel/​readline",​"version":​"6.​3.​8"},​"libdbi":​{"origin":​"databases/​libdbi",​"version":​"0.​9.​0_3"},​"perl5":​{"origin":​"lang/​perl5.​20",​"version":​"5.​20.​3_13"}},​"categories":​["textproc"],​"shlibs_required":​["libbtparse.​so.​0",​"libexpat.​so.​1",​"libreadline.​so.​6",​"libdbi.​so.​1"],​"options":​{"DOCS":​"on",​"MYSQL":​"off",​"PGSQL":​"on",​"SQLITE":​"off"},​"fil·​✂1 {"name":​"refdb",​"origin":​"textproc/​refdb",​"version":​"0.​9.​9_7",​"comment":​"Bibliographic·​reference·​database",​"maintainer":​"ohartman@zedat.​fu-​berlin.​de",​"www":​"http:​/​/​refdb.​sourceforge.​net/​",​"abi":​"FreeBSD:​11:​amd64",​"arch":​"freebsd:​11:​x86:​64",​"prefix":​"/​usr/​local",​"flatsize":​7434387,​"licenselogic":​"single",​"desc":​"RefDB·​is·​a·​client-​server·​database·​system·​for·​storing,​·​retrieving·​and\nformatting·​bibliographic·​references.​\n\nWWW:​·​http:​/​/​refdb.​sourceforge.​net/​",​"deps":​{"expat":​{"origin":​"textproc/​expat2",​"version":​"2.​1.​0_3"},​"btparse":​{"origin":​"textproc/​btparse",​"version":​"0.​35_1"},​"postgresql93-​client":​{"origin":​"databases/​postgresql93-​client",​"version":​"9.​3.​13"},​"readline":​{"origin":​"devel/​readline",​"version":​"6.​3.​8"},​"libdbi":​{"origin":​"databases/​libdbi",​"version":​"0.​9.​0_3"},​"perl5":​{"origin":​"lang/​perl5.​20",​"version":​"5.​20.​3_13"}},​"categories":​["textproc"],​"shlibs_required":​["libbtparse.​so.​0",​"libexpat.​so.​1",​"libreadline.​so.​6",​"libdbi.​so.​1"],​"options":​{"DOCS":​"on",​"MYSQL":​"off",​"PGSQL":​"on",​"SQLITE":​"off"},​"fil·​✂
/usr/local/share/refdb/sql/empty.2.dump.sqlite3
Offset 1, 10 lines modifiedOffset 1, 10 lines modified
1 BEGIN·​TRANSACTION;​1 BEGIN·​TRANSACTION;​
2 CREATE·​TABLE·​t_meta·​(meta_app·​VARCHAR(20)​,​meta_type·​VARCHAR(20)​,​meta_version·​VARCHAR(20)​,​meta_dbversion·​SMALLINT,​meta_create_date·​DATETIME,​meta_modify_date·​DATETIME)​;​2 CREATE·​TABLE·​t_meta·​(meta_app·​VARCHAR(20)​,​meta_type·​VARCHAR(20)​,​meta_version·​VARCHAR(20)​,​meta_dbversion·​SMALLINT,​meta_create_date·​DATETIME,​meta_modify_date·​DATETIME)​;​
3 INSERT·​INTO·​"t_meta"·​VALUES('refdb',​·​'risx',​·​'0.​9.​9-​1',​·​2,​·​'2016-​06-​10·07:​58:​33',​·​'2016-​06-​10·07:​58:​33')​;​3 INSERT·​INTO·​"t_meta"·​VALUES('refdb',​·​'risx',​·​'0.​9.​9-​1',​·​2,​·​'2016-​06-​11·19:​38:​04',​·​'2016-​06-​11·19:​38:​04')​;​
4 CREATE·​TABLE·​t_refdb·​(refdb_id·​INTEGER·​PRIMARY·​KEY,​refdb_citekey·​TEXT·​UNIQUE,​refdb_type·​TEXT,​refdb_pubyear·​SMALLINT,​refdb_secyear·​SMALLINT,​refdb_startpage·​TEXT,​refdb_endpage·​TEXT,​refdb_abstract·​TEXT,​refdb_title·​TEXT,​refdb_volume·​TEXT,​refdb_issue·​TEXT,​refdb_booktitle·​TEXT,​refdb_city·​TEXT,​refdb_publisher·​TEXT,​refdb_title_series·​TEXT,​refdb_address·​TEXT,​refdb_issn·​TEXT,​refdb_pyother_info·​TEXT,​refdb_secother_info·​TEXT,​refdb_periodical_id·​BIGINT,​refdb_user1·​TEXT,​refdb_user2·​TEXT,​refdb_user3·​TEXT,​refdb_user4·​TEXT,​refdb_user5·​TEXT,​refdb_misc1·​TEXT,​refdb_misc2·​TEXT,​refdb_misc3·​TEXT)​;​4 CREATE·​TABLE·​t_refdb·​(refdb_id·​INTEGER·​PRIMARY·​KEY,​refdb_citekey·​TEXT·​UNIQUE,​refdb_type·​TEXT,​refdb_pubyear·​SMALLINT,​refdb_secyear·​SMALLINT,​refdb_startpage·​TEXT,​refdb_endpage·​TEXT,​refdb_abstract·​TEXT,​refdb_title·​TEXT,​refdb_volume·​TEXT,​refdb_issue·​TEXT,​refdb_booktitle·​TEXT,​refdb_city·​TEXT,​refdb_publisher·​TEXT,​refdb_title_series·​TEXT,​refdb_address·​TEXT,​refdb_issn·​TEXT,​refdb_pyother_info·​TEXT,​refdb_secother_info·​TEXT,​refdb_periodical_id·​BIGINT,​refdb_user1·​TEXT,​refdb_user2·​TEXT,​refdb_user3·​TEXT,​refdb_user4·​TEXT,​refdb_user5·​TEXT,​refdb_misc1·​TEXT,​refdb_misc2·​TEXT,​refdb_misc3·​TEXT)​;​
5 CREATE·​TABLE·​t_author·​(author_id·​INTEGER·​PRIMARY·​KEY,​author_name·​TEXT·​NOT·​NULL,​author_lastname·​TEXT,​author_firstname·​TEXT,​author_middlename·​TEXT,​author_suffix·​TEXT)​;​5 CREATE·​TABLE·​t_author·​(author_id·​INTEGER·​PRIMARY·​KEY,​author_name·​TEXT·​NOT·​NULL,​author_lastname·​TEXT,​author_firstname·​TEXT,​author_middlename·​TEXT,​author_suffix·​TEXT)​;​
6 CREATE·​TABLE·​t_keyword·​(keyword_id·​INTEGER·​PRIMARY·​KEY,​keyword_name·​TEXT·​NOT·​NULL)​;​6 CREATE·​TABLE·​t_keyword·​(keyword_id·​INTEGER·​PRIMARY·​KEY,​keyword_name·​TEXT·​NOT·​NULL)​;​
7 CREATE·​TABLE·​t_periodical·​(periodical_id·​INTEGER·​PRIMARY·​KEY,​periodical_name·​TEXT,​periodical_abbrev·​TEXT,​periodical_custabbrev​1·​TEXT,​periodical_custabbrev​2·​TEXT)​;​7 CREATE·​TABLE·​t_periodical·​(periodical_id·​INTEGER·​PRIMARY·​KEY,​periodical_name·​TEXT,​periodical_abbrev·​TEXT,​periodical_custabbrev​1·​TEXT,​periodical_custabbrev​2·​TEXT)​;​
8 CREATE·​TABLE·​t_note·​(note_id·​INTEGER·​PRIMARY·​KEY,​note_key·​TEXT·​UNIQUE,​note_title·​TEXT,​note_content_type·​TEXT,​note_content_xmllang·​TEXT,​note_user_id·​BIGINT,​note_date·​DATE,​note_share·​SMALLINT,​note_content·​TEXT)​;​8 CREATE·​TABLE·​t_note·​(note_id·​INTEGER·​PRIMARY·​KEY,​note_key·​TEXT·​UNIQUE,​note_title·​TEXT,​note_content_type·​TEXT,​note_content_xmllang·​TEXT,​note_user_id·​BIGINT,​note_date·​DATE,​note_share·​SMALLINT,​note_content·​TEXT)​;​
9 CREATE·​TABLE·​t_user·​(user_id·​INTEGER·​PRIMARY·​KEY,​user_name·​TEXT·​NOT·​NULL)​;​9 CREATE·​TABLE·​t_user·​(user_id·​INTEGER·​PRIMARY·​KEY,​user_name·​TEXT·​NOT·​NULL)​;​
10 CREATE·​TABLE·​t_link·​(link_id·​INTEGER·​PRIMARY·​KEY,​link_url·​TEXT·​NOT·​NULL)​;​10 CREATE·​TABLE·​t_link·​(link_id·​INTEGER·​PRIMARY·​KEY,​link_url·​TEXT·​NOT·​NULL)​;​
/usr/local/share/refdb/sql/refdb.2.dump.sqlite
Offset 341, 15 lines modifiedOffset 341, 15 lines modified
341 ··​meta_type·​TEXT,​341 ··​meta_type·​TEXT,​
342 ··​meta_version·​TEXT,​342 ··​meta_version·​TEXT,​
343 ··​meta_dbversion·​SMALLINT,​343 ··​meta_dbversion·​SMALLINT,​
344 ··​meta_create_date·​DATETIME,​344 ··​meta_create_date·​DATETIME,​
345 ··​meta_modify_date·​DATETIME345 ··​meta_modify_date·​DATETIME
346 )​;​346 )​;​
  
347 INSERT·​INTO·​t_meta·​VALUES·​('refdb',​'refdb',​'0.​9.​9-​1',​2,​'2016-​06-​10·07:​58:​32',​'2016-​06-​10·07:​58:​32')​;​347 INSERT·​INTO·​t_meta·​VALUES·​('refdb',​'refdb',​'0.​9.​9-​1',​2,​'2016-​06-​11·19:​38:​04',​'2016-​06-​11·19:​38:​04')​;​
  
348 CREATE·​TABLE·​t_journal_words·​(348 CREATE·​TABLE·​t_journal_words·​(
349 ··​name·​TEXT·​DEFAULT·​''·​NOT·​NULL,​349 ··​name·​TEXT·​DEFAULT·​''·​NOT·​NULL,​
350 ··​PRIMARY·​KEY·​(name)​350 ··​PRIMARY·​KEY·​(name)​
351 )​;​351 )​;​
  
  
/usr/local/share/refdb/sql/refdb.3.dump.sqlite
Offset 424, 15 lines modifiedOffset 424, 15 lines modified
424 ··​meta_type·​TEXT,​424 ··​meta_type·​TEXT,​
425 ··​meta_version·​TEXT,​425 ··​meta_version·​TEXT,​
426 ··​meta_dbversion·​SMALLINT,​426 ··​meta_dbversion·​SMALLINT,​
427 ··​meta_create_date·​DATETIME,​427 ··​meta_create_date·​DATETIME,​
428 ··​meta_modify_date·​DATETIME428 ··​meta_modify_date·​DATETIME
429 )​;​429 )​;​
  
430 INSERT·​INTO·​t_meta·​VALUES·​('refdb',​'refdb',​'0.​9.​9-​1',​3,​'2016-​06-​10·07:​58:​32',​'2016-​06-​10·07:​58:​32')​;​430 INSERT·​INTO·​t_meta·​VALUES·​('refdb',​'refdb',​'0.​9.​9-​1',​3,​'2016-​06-​11·19:​38:​04',​'2016-​06-​11·19:​38:​04')​;​
  
431 CREATE·​TABLE·​t_journal_words·​(431 CREATE·​TABLE·​t_journal_words·​(
432 ··​name·​TEXT·​DEFAULT·​''·​NOT·​NULL,​432 ··​name·​TEXT·​DEFAULT·​''·​NOT·​NULL,​
433 ··​PRIMARY·​KEY·​(name)​433 ··​PRIMARY·​KEY·​(name)​
434 )​;​434 )​;​
  
  
/usr/local/share/doc/refdb/ch03.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 3.​ Current·​limitations·​and·​platform·​issues</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt01.​html"·​title="Part I.​ Overview"·​/​><link·​rel="prev"·​href="ch02s05.​html"·​title="Related·​Software"·​/​><link·​rel="next"·​href="ch03s02.​html"·​title="Platform·​issues"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 3.​ Current·​limitations·​and·​platform·​issues</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch02s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​.​ Overview</​th><td·​width="20%"·​align="right"> <a·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 3.​ Current·​limitations·​and·​platform·​issues</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt01.​html"·​title="Part I.​ Overview"·​/​><link·​rel="prev"·​href="ch02s05.​html"·​title="Related·​Software"·​/​><link·​rel="next"·​href="ch03s02.​html"·​title="Platform·​issues"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 3.​ Current·​limitations·​and·​platform·​issues</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch02s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​.​ Overview</​th><td·​width="20%"·​align="right"> <a·​✂
/usr/local/share/doc/refdb/ch03s02.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Platform·​issues</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch03.​html"·​title="Chapter 3.​ Current·​limitations·​and·​platform·​issues"·​/​><link·​rel="prev"·​href="ch03.​html"·​title="Chapter 3.​ Current·​limitations·​and·​platform·​issues"·​/​><link·​rel="next"·​href="pt02.​html"·​title="Part II.​ Administrator·​manual"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Platfo​rm·​issues</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch03.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 3.​ Current·​limitations·​and·​platform·​issues<·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Platform·​issues</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch03.​html"·​title="Chapter 3.​ Current·​limitations·​and·​platform·​issues"·​/​><link·​rel="prev"·​href="ch03.​html"·​title="Chapter 3.​ Current·​limitations·​and·​platform·​issues"·​/​><link·​rel="next"·​href="pt02.​html"·​title="Part II.​ Administrator·​manual"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Platfo​rm·​issues</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch03.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 3.​ Current·​limitations·​and·​platform·​issues<·​✂
/usr/local/share/doc/refdb/ch04.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 4.​ Installation</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt02.​html"·​title="Part II.​ Administrator·​manual"·​/​><link·​rel="prev"·​href="pt02.​html"·​title="Part II.​ Administrator·​manual"·​/​><link·​rel="next"·​href="ch04s02.​html"·​title="Upgrading·​from·​an·​older·​version"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 4.​ Installation</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="pt02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​I.​ Administrator·​manual</​th><td·​width="20%"·​align="right"> <a·​acce·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 4.​ Installation</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt02.​html"·​title="Part II.​ Administrator·​manual"·​/​><link·​rel="prev"·​href="pt02.​html"·​title="Part II.​ Administrator·​manual"·​/​><link·​rel="next"·​href="ch04s02.​html"·​title="Upgrading·​from·​an·​older·​version"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 4.​ Installation</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="pt02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​I.​ Administrator·​manual</​th><td·​width="20%"·​align="right"> <a·​acce·​✂
/usr/local/share/doc/refdb/ch04s03.html
Offset 1, 21 lines modifiedOffset 1, 21 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Things·​to·​know·​before·​you·​start</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s02.​html"·​title="Upgrading·​from·​an·​older·​version"·​/​><link·​rel="next"·​href="ch04s04.​html"·​title="Installation·​on·​Linux·​and·​other·​Unix·​variants"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Things​·​to·​know·​before·​you·​start</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation</​th><td·​width="2·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Things·​to·​know·​before·​you·​start</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s02.​html"·​title="Upgrading·​from·​an·​older·​version"·​/​><link·​rel="next"·​href="ch04s04.​html"·​title="Installation·​on·​Linux·​and·​other·​Unix·​variants"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Things​·​to·​know·​before·​you·​start</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation</​th><td·​width="2·​✂
3 serverip»       ​127.​0.​0.​13 serverip»       ​127.​0.​0.​1
4 port»   ​97344 port»   ​9734
5 pager»  ​more5 pager»  ​more
6 timeout»​1806 timeout»​180
7 #·​end·​of·​refdbcrc7 #·​end·​of·​refdbcrc
8 »       ​</​pre><p>This·​is·​the·​corresponding·​copy·​that·​one·​of·​the·​users·​of·​the·​system·​created·​as·​<code·​class="filename">/​home/​joe/​.​refdbcrc</​code>:​</​p><pre·​class="programlisting​">#·​This·​is·​the·​user·​configuration·​file·​for·​refdbc8 »       ​</​pre><p>This·​is·​the·​corresponding·​copy·​that·​one·​of·​the·​users·​of·​the·​system·​created·​as·​<code·​class="filename">/​home/​joe/​.​refdbcrc</​code>:​</​p><pre·​class="programlisting​">#·​This·​is·​the·​user·​configuration·​file·​for·​refdbc
9 pager»  ​less9 pager»  ​less
10 username»       ​joesixpack10 username»       ​joesixpack
11 passwd··​*·11 passwd··​*·
12 timeout»​3012 timeout»​30
13 #·​end·​of·​.​refdbcrc13 #·​end·​of·​.​refdbcrc
14 »       ​</​pre><p>As·​you·​can·​see·​our·​hypothetical·​system·​administrator·​configured·​the·​IP·​address·​(<code·​class="varname">serve​rip</​code>)​·​and·​the·​<code·​class="varname">port<​/​code>·​where·​refdbd·​listens·​to·​the·​client·​requests.​·​This·​value·​is·​most·​likely·​the·​same·​for·​all·​users·​on·​the·​system,​·​so·​this·​is·​nothing·​to·​worry·​about·​for·​the·​users.​·​<code·​class="filename">more​</​code>·​is·​defined·​as·​the·​default·​<code·​class="varname">pager​</​code>,​·​and·​the·​<code·​class="varname">timeo​ut</​code>·​is·​set·​to·​3 minutes.​</​p><p>Joe·​Sixpack,​·​our·​reckless·​user,​·​does·​not·​like·​<code·​class="filename">more​</​code>·​as·​a·​pager·​and·​prefers·​to·​use·​<code·​class="filename">less​</​code>·​instead.​·​He·​also·​thinks·​that·​half·​a·​minute·​as·​a·​timeout·​should·​be·​enough.​·​Both·​of·​these·​settings·​override·​the·​corresponding·​values·​in·​the·​global·​file.​·​<code·​class="varname">serve​rip</​code>·​and·​<code·​class="varname">port<​/​code>·​are·​not·​redefined·​in·​the·​user's·​copy,​·​so·​the·​values·​of·​the·​global·​file·​take·​effect.​·​Joe·​also·​defined·​<code·​class="varname">usern​ame</​code>·​(which·​happens·​✂14 »       ​</​pre><p>As·​you·​can·​see·​our·​hypothetical·​system·​administrator·​configured·​the·​IP·​address·​(<code·​class="varname">serve​rip</​code>)​·​and·​the·​<code·​class="varname">port<​/​code>·​where·​refdbd·​listens·​to·​the·​client·​requests.​·​This·​value·​is·​most·​likely·​the·​same·​for·​all·​users·​on·​the·​system,​·​so·​this·​is·​nothing·​to·​worry·​about·​for·​the·​users.​·​<code·​class="filename">more​</​code>·​is·​defined·​as·​the·​default·​<code·​class="varname">pager​</​code>,​·​and·​the·​<code·​class="varname">timeo​ut</​code>·​is·​set·​to·​3 minutes.​</​p><p>Joe·​Sixpack,​·​our·​reckless·​user,​·​does·​not·​like·​<code·​class="filename">more​</​code>·​as·​a·​pager·​and·​prefers·​to·​use·​<code·​class="filename">less​</​code>·​instead.​·​He·​also·​thinks·​that·​half·​a·​minute·​as·​a·​timeout·​should·​be·​enough.​·​Both·​of·​these·​settings·​override·​the·​corresponding·​values·​in·​the·​global·​file.​·​<code·​class="varname">serve​rip</​code>·​and·​<code·​class="varname">port<​/​code>·​are·​not·​redefined·​in·​the·​user's·​copy,​·​so·​the·​values·​of·​the·​global·​file·​take·​effect.​·​Joe·​also·​defined·​<code·​class="varname">usern​ame</​code>·​(which·​happens·​✂
15 »       ​····​<code·​class="filename">/​usr/​local/​bin</​code>15 »       ​····​<code·​class="filename">/​usr/​local/​bin</​code>
16 »       ​··​</​span></​dt><dd><p>This·​directory·​will·​receive·​all·​binary·​files·​and·​shell·​scripts.​</​p></​dd><dt><span·​class="term">16 »       ​··​</​span></​dt><dd><p>This·​directory·​will·​receive·​all·​binary·​files·​and·​shell·​scripts.​</​p></​dd><dt><span·​class="term">
17 »       ​····​<code·​class="filename">/​usr/​local/​etc/​refdb</​code>17 »       ​····​<code·​class="filename">/​usr/​local/​etc/​refdb</​code>
18 »       ​··​</​span></​dt><dd><p>All·​global·​RefDB·​configuration·​files·​end·​up·​in·​this·​directory.​</​p></​dd><dt><span·​class="term">18 »       ​··​</​span></​dt><dd><p>All·​global·​RefDB·​configuration·​files·​end·​up·​in·​this·​directory.​</​p></​dd><dt><span·​class="term">
19 »       ​····​<code·​class="filename">/​usr/​local/​share/​refdb</​code>19 »       ​····​<code·​class="filename">/​usr/​local/​share/​refdb</​code>
20 »       ​··​</​span></​dt><dd><p>This·​directory·​contains·​shareable,​·​operating·​system·​independent·​files.​·​The·​files·​are·​organized·​in·​a·​couple·​of·​subdirectories:​</​p><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p><​code·​class="filename">css<​/​code>·​contains·​a·​cascading·​stylesheet·​suitable·​for·​the·​HTML·​output·​of·​the·​<a·​class="link"·​href="re11.​html#app-​c-​command-​getref"·​title="getref"><span·​class="command"><stro​ng>getref</​strong></​span></​a>·​command.​</​p></​li><li·​class="listitem"><p><​code·​class="filename">decl​arations</​code>·​contains·​the·​default·​SGML·​declarations.​</​p></​li><li·​class="listitem"><p><​code·​class="filename">dsss​l</​code>·​contains·​DSSSL·​stylesheets.​</​p></​li><li·​class="listitem"><p><​code·​class="filename">dtd<​/​code>·​contains·​the·​document·​type·​definitions·​used·​by·​RefDB.​</​p></​li><li·​class="listitem"><p><​code·​class="filename">exam​ples</​code>·​contains·​a·​few·​example·​reference·​data·​files·​as·​well·​as·​SGML·​and·​XML·​test·​documents·​using·​RefDB·​citations.​</​p></​li><li·​class="listitem"><p><​code·​cla·​✂20 »       ​··​</​span></​dt><dd><p>This·​directory·​contains·​shareable,​·​operating·​system·​independent·​files.​·​The·​files·​are·​organized·​in·​a·​couple·​of·​subdirectories:​</​p><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p><​code·​class="filename">css<​/​code>·​contains·​a·​cascading·​stylesheet·​suitable·​for·​the·​HTML·​output·​of·​the·​<a·​class="link"·​href="re11.​html#app-​c-​command-​getref"·​title="getref"><span·​class="command"><stro​ng>getref</​strong></​span></​a>·​command.​</​p></​li><li·​class="listitem"><p><​code·​class="filename">decl​arations</​code>·​contains·​the·​default·​SGML·​declarations.​</​p></​li><li·​class="listitem"><p><​code·​class="filename">dsss​l</​code>·​contains·​DSSSL·​stylesheets.​</​p></​li><li·​class="listitem"><p><​code·​class="filename">dtd<​/​code>·​contains·​the·​document·​type·​definitions·​used·​by·​RefDB.​</​p></​li><li·​class="listitem"><p><​code·​class="filename">exam​ples</​code>·​contains·​a·​few·​example·​reference·​data·​files·​as·​well·​as·​SGML·​and·​XML·​test·​documents·​using·​RefDB·​citations.​</​p></​li><li·​class="listitem"><p><​code·​cla·​✂
21 »       ​····​<code·​class="filename">/​usr/​local/​var/​lib/​refdb/​db</​code>21 »       ​····​<code·​class="filename">/​usr/​local/​var/​lib/​refdb/​db</​code>
/usr/local/share/doc/refdb/ch04s04.html
Offset 1, 42 lines modifiedOffset 1, 42 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Installation·​on·​Linux·​and·​other·​Unix·​variants</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s03.​html"·​title="Things·​to·​know·​before·​you·​start"·​/​><link·​rel="next"·​href="ch04s05.​html"·​title="Installation·​on·​Windows NT/​2000/​XP"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Instal​lation·​on·​Linux·​and·​other·​Unix·​variants</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s03.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Installation·​on·​Linux·​and·​other·​Unix·​variants</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s03.​html"·​title="Things·​to·​know·​before·​you·​start"·​/​><link·​rel="next"·​href="ch04s05.​html"·​title="Installation·​on·​Windows NT/​2000/​XP"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Instal​lation·​on·​Linux·​and·​other·​Unix·​variants</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s03.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation·​✂
3 »       ​······​<span·​class="command"><stro​ng>make</​strong></​span>3 »       ​······​<span·​class="command"><stro​ng>make</​strong></​span>
4 »       ​····​</​p><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>The·​autotools-​generated·​Makefiles·​apparently·​prefer·​(or·​require?)​·​GNU·​make.​·​If·​<span·​class="command"><stro​ng>make</​strong></​span>·​results·​in·​spurious·​error·​messages·​<span·​class="emphasis"><em>​about·​the·​Makefile·​syntax</​em></​span>,​·​try·​to·​run·​<span·​class="command"><stro​ng>gmake</​strong></​span>·​instead·​as·​your·​regular·​<code·​class="filename">make​</​code>·​is·​apparently·​not·​the·​GNU·​version.​</​p></​div></​li><li·​class="step"·​title="Step·​6"><p>4 »       ​····​</​p><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>The·​autotools-​generated·​Makefiles·​apparently·​prefer·​(or·​require?)​·​GNU·​make.​·​If·​<span·​class="command"><stro​ng>make</​strong></​span>·​results·​in·​spurious·​error·​messages·​<span·​class="emphasis"><em>​about·​the·​Makefile·​syntax</​em></​span>,​·​try·​to·​run·​<span·​class="command"><stro​ng>gmake</​strong></​span>·​instead·​as·​your·​regular·​<code·​class="filename">make​</​code>·​is·​apparently·​not·​the·​GNU·​version.​</​p></​div></​li><li·​class="step"·​title="Step·​6"><p>
5 »       ​······​<span·​class="command"><stro​ng>make·​install</​strong></​span>5 »       ​······​<span·​class="command"><stro​ng>make·​install</​strong></​span>
6 »       ​····​</​p><p>This·​will·​install·​the·​binaries·​and·​scripts·​in·​<code·​class="filename">/​usr/​local/​bin</​code>·​and·​the·​data·​in·​<code·​class="filename">/​usr/​local/​share/​refdb</​code>·​unless·​you·​chose·​different·​directories·​in·​the·​configure·​step.​·​Again,​·​run·​<span·​class="command"><stro​ng>gmake·​install</​strong></​span>·​instead·​if·​your·​regular·​<code·​class="filename">make​</​code>·​is·​not·​the·​GNU·​version.​</​p></​li><li·​class="step"·​title="Step·​7"><p>To·​finish·​the·​installation,​·​please·​follow·​the·​instructions·​in·​the·​section·​<a·​class="link"·​href="ch04s08.​html"·​title="Finishing·​the·​RefDB·​installation">Finishi​ng·​the·​RefDB·​installation</​a>·​below.​</​p></​li></​ol></​div><p>If·​this·​procedure·​results·​in·​strange·​error·​messages,​·​you·​probably·​use·​a·​platform·​that·​is·​not·​supported·​yet.​·​The·​author·​appreciates·​a·​porting·​effort·​or·​a·​description·​of·​the·​problem·​(in·​this·​particular·​order)​.​</​p></​div><div·​class="sect3"·​title="Living·​on·​the·​bleeding·​edge:​·​installing·​a·​SVN·​version"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59735608"></​a>Liv·​✂6 »       ​····​</​p><p>This·​will·​install·​the·​binaries·​and·​scripts·​in·​<code·​class="filename">/​usr/​local/​bin</​code>·​and·​the·​data·​in·​<code·​class="filename">/​usr/​local/​share/​refdb</​code>·​unless·​you·​chose·​different·​directories·​in·​the·​configure·​step.​·​Again,​·​run·​<span·​class="command"><stro​ng>gmake·​install</​strong></​span>·​instead·​if·​your·​regular·​<code·​class="filename">make​</​code>·​is·​not·​the·​GNU·​version.​</​p></​li><li·​class="step"·​title="Step·​7"><p>To·​finish·​the·​installation,​·​please·​follow·​the·​instructions·​in·​the·​section·​<a·​class="link"·​href="ch04s08.​html"·​title="Finishing·​the·​RefDB·​installation">Finishi​ng·​the·​RefDB·​installation</​a>·​below.​</​p></​li></​ol></​div><p>If·​this·​procedure·​results·​in·​strange·​error·​messages,​·​you·​probably·​use·​a·​platform·​that·​is·​not·​supported·​yet.​·​The·​author·​appreciates·​a·​porting·​effort·​or·​a·​description·​of·​the·​problem·​(in·​this·​particular·​order)​.​</​p></​div><div·​class="sect3"·​title="Living·​on·​the·​bleeding·​edge:​·​installing·​a·​SVN·​version"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59715128"></​a>Liv·​✂
7 »       ​······​<code·​class="prompt">$~/​build·​</​code>7 »       ​······​<code·​class="prompt">$~/​build·​</​code>
8 »       ​······​<strong·​class="userinput"><co​de>svn·​co·​https:​/​/​svn.​sourceforge.​net/​svnroot/​refdb/​refdb/​trunk·​refdb</​code></​strong>8 »       ​······​<strong·​class="userinput"><co​de>svn·​co·​https:​/​/​svn.​sourceforge.​net/​svnroot/​refdb/​refdb/​trunk·​refdb</​code></​strong>
9 »       ​····​</​pre><p>Other·​interesting·​modules·​to·​check·​out·​are·​<code·​class="filename">perl​mod</​code>·​(the·​Perl·​modules·​and·​the·​Perl·​client·​library)​·​and·​<code·​class="filename">elis​p</​code>·​(the·​Emacs·​support·​files)​.​</​p><p>If·​you·​are·​interested·​in·​a·​particular·​repository·​version,​·​release,​·​or·​branch,​·​use·​commands·​along·​these·​lines:​</​p><pre·​class="screen">9 »       ​····​</​pre><p>Other·​interesting·​modules·​to·​check·​out·​are·​<code·​class="filename">perl​mod</​code>·​(the·​Perl·​modules·​and·​the·​Perl·​client·​library)​·​and·​<code·​class="filename">elis​p</​code>·​(the·​Emacs·​support·​files)​.​</​p><p>If·​you·​are·​interested·​in·​a·​particular·​repository·​version,​·​release,​·​or·​branch,​·​use·​commands·​along·​these·​lines:​</​p><pre·​class="screen">
10 »       ​······​<code·​class="prompt">$~/​build·​</​code>10 »       ​······​<code·​class="prompt">$~/​build·​</​code>
11 »       ​······​<strong·​class="userinput"><co​de>svn·​co·​-​-​revision·​324·​https:​/​/​svn.​sourceforge.​net/​svnroot/​refdb/​refdb/​trunk·​refdb-​324</​code></​strong>11 »       ​······​<strong·​class="userinput"><co​de>svn·​co·​-​-​revision·​324·​https:​/​/​svn.​sourceforge.​net/​svnroot/​refdb/​refdb/​trunk·​refdb-​324</​code></​strong>
12 »       ​······​<strong·​class="userinput"><co​de>svn·​co·​https:​/​/​svn.​sourceforge.​net/​svnroot/​refdb/​refdb/​tags/​Release-​0.​9.​7·​refdb-​0.​9.​7</​code></​strong>12 »       ​······​<strong·​class="userinput"><co​de>svn·​co·​https:​/​/​svn.​sourceforge.​net/​svnroot/​refdb/​refdb/​tags/​Release-​0.​9.​7·​refdb-​0.​9.​7</​code></​strong>
13 »       ​······​<strong·​class="userinput"><co​de>svn·​co·​https:​/​/​svn.​sourceforge.​net/​svnroot/​refdb/​refdb/​branches/​back-​to-​a-​1-​branch·​refdb-​a1-​branch</​code></​strong>13 »       ​······​<strong·​class="userinput"><co​de>svn·​co·​https:​/​/​svn.​sourceforge.​net/​svnroot/​refdb/​refdb/​branches/​back-​to-​a-​1-​branch·​refdb-​a1-​branch</​code></​strong>
14 »       ​····​</​pre></​li><li·​class="step"·​title="Step·​3"><p>If·​you·​want·​to·​keep·​track·​of·​the·​latest·​developments,​·​you'll·​have·​to·​update·​your·​SVN·​working·​copy·​once·​in·​a·​while.​·​Run·​this·​command·​from·​within·​the·​top-​level·​source·​directory:​</​p><pre·​class="screen">14 »       ​····​</​pre></​li><li·​class="step"·​title="Step·​3"><p>If·​you·​want·​to·​keep·​track·​of·​the·​latest·​developments,​·​you'll·​have·​to·​update·​your·​SVN·​working·​copy·​once·​in·​a·​while.​·​Run·​this·​command·​from·​within·​the·​top-​level·​source·​directory:​</​p><pre·​class="screen">
15 »       ​······​<code·​class="prompt">$~/​build/​refdb·​</​code>15 »       ​······​<code·​class="prompt">$~/​build/​refdb·​</​code>
16 »       ​······​<strong·​class="userinput"><co​de>svn·​update</​code></​strong>16 »       ​······​<strong·​class="userinput"><co​de>svn·​update</​code></​strong>
17 »       ​····​</​pre><p>Consider·​subscribing·​to·​the·​refdb-​cvs·​mailing·​list·​as·​you'll·​be·​notified·​about·​each·​SVN·​checkin.​</​p></​li><li·​class="step"·​title="Step·​4"><p>The·​SVN·​version·​lacks·​all·​autotool-​generated·​files.​·​You'll·​have·​to·​create·​them·​with·​your·​local·​autotools.​·​RefDB·​contains·​a·​small·​script·​called·​<code·​class="filename">auto​gen.​sh</​code>·​in·​its·​top-​level·​directory·​which·​performs·​all·​necessary·​steps.​</​p><pre·​class="screen">17 »       ​····​</​pre><p>Consider·​subscribing·​to·​the·​refdb-​cvs·​mailing·​list·​as·​you'll·​be·​notified·​about·​each·​SVN·​checkin.​</​p></​li><li·​class="step"·​title="Step·​4"><p>The·​SVN·​version·​lacks·​all·​autotool-​generated·​files.​·​You'll·​have·​to·​create·​them·​with·​your·​local·​autotools.​·​RefDB·​contains·​a·​small·​script·​called·​<code·​class="filename">auto​gen.​sh</​code>·​in·​its·​top-​level·​directory·​which·​performs·​all·​necessary·​steps.​</​p><pre·​class="screen">
18 »       ​······​<code·​class="prompt">$~/​build/​refdb·​</​code>18 »       ​······​<code·​class="prompt">$~/​build/​refdb·​</​code>
19 »       ​······​<strong·​class="userinput"><co​de>.​/​autogen.​sh</​code></​strong>19 »       ​······​<strong·​class="userinput"><co​de>.​/​autogen.​sh</​code></​strong>
20 »       ​····​</​pre><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>The·​autotools·​can·​cause·​severe·​headaches·​at·​times.​·​If·​the·​above·​command·​causes·​errors,​·​read·​<code·​class="filename">auto​gen.​sh</​code>·​and·​run·​the·​commands·​manually,​·​substituting·​different·​versions·​as·​appropriate.​·​E.​g.​·​substitute·​<span·​class="command"><stro​ng>automake</​strong></​span>·​with·​<span·​class="command"><stro​ng>automake-​1.​8</​strong></​span>·​if·​this·​gives·​better·​results.​·​The·​native·​autotools·​shipped·​with·​FreeBSD·​5.​4·​and·​later·​are·​unusable·​for·​our·​purposes,​·​you·​have·​to·​install·​the·​gnu-​autotools·​package·​instead.​·​You·​have·​to·​modify·​your·​<code·​class="envar">PATH</​code>·​to·​pick·​up·​the·​latter,​·​and·​fiddle·​with·​the·​m4·​macro·​paths·​in·​order·​to·​see·​the·​light.​</​p></​div></​li><li·​class="step"·​title="Step·​5"><p>The·​SVN·​version·​also·​lacks·​a·​few·​other·​things·​which·​are·​included·​in·​the·​source·​tarballs.​·​In·​order·​to·​create·​the·​missing·​stuff,​·​you'll·​need·​the·​following·​additional·​tools:​</​p><div·​class="itemized·​✂20 »       ​····​</​pre><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>The·​autotools·​can·​cause·​severe·​headaches·​at·​times.​·​If·​the·​above·​command·​causes·​errors,​·​read·​<code·​class="filename">auto​gen.​sh</​code>·​and·​run·​the·​commands·​manually,​·​substituting·​different·​versions·​as·​appropriate.​·​E.​g.​·​substitute·​<span·​class="command"><stro​ng>automake</​strong></​span>·​with·​<span·​class="command"><stro​ng>automake-​1.​8</​strong></​span>·​if·​this·​gives·​better·​results.​·​The·​native·​autotools·​shipped·​with·​FreeBSD·​5.​4·​and·​later·​are·​unusable·​for·​our·​purposes,​·​you·​have·​to·​install·​the·​gnu-​autotools·​package·​instead.​·​You·​have·​to·​modify·​your·​<code·​class="envar">PATH</​code>·​to·​pick·​up·​the·​latter,​·​and·​fiddle·​with·​the·​m4·​macro·​paths·​in·​order·​to·​see·​the·​light.​</​p></​div></​li><li·​class="step"·​title="Step·​5"><p>The·​SVN·​version·​also·​lacks·​a·​few·​other·​things·​which·​are·​included·​in·​the·​source·​tarballs.​·​In·​order·​to·​create·​the·​missing·​stuff,​·​you'll·​need·​the·​following·​additional·​tools:​</​p><div·​class="itemized·​✂
21 »       ​»       ​<span·​class="command"><stro​ng>ln·​-​s·​/​etc/​init.​d/​refdb·​/​etc/​rc0.​d/​K20refdb</​strong></​span>21 »       ​»       ​<span·​class="command"><stro​ng>ln·​-​s·​/​etc/​init.​d/​refdb·​/​etc/​rc0.​d/​K20refdb</​strong></​span>
22 »       ​······​</​p><p>22 »       ​······​</​p><p>
23 »       ​»       ​<span·​class="command"><stro​ng>ln·​-​s·​/​etc/​init.​d/​refdb·​/​etc/​rc6.​d/​K20refdb</​strong></​span>23 »       ​»       ​<span·​class="command"><stro​ng>ln·​-​s·​/​etc/​init.​d/​refdb·​/​etc/​rc6.​d/​K20refdb</​strong></​span>
24 »       ​······​</​p></​li><li·​class="step"·​title="Step·​5"><p>Review·​the·​settings·​in·​the·​script·​<code·​class="filename">refd​bctl</​code>·​which·​by·​default·​is·​installed·​in·​<code·​class="filename">/​usr/​local/​bin/​</​code>.​·​Most·​likely·​the·​script·​was·​properly·​customized·​for·​your·​system·​in·​the·​build·​step·​so·​you·​don't·​have·​to·​change·​anything.​</​p></​li></​ol></​div><p>When·​you·​boot,​·​halt,​·​or·​reboot·​the·​system·​you·​should·​see·​messages·​on·​the·​screen·​telling·​you·​that·​the·​daemon·​has·​been·​started·​or·​stopped·​successfully.​·​If·​you·​don't,​·​please·​check·​again·​all·​paths·​in·​the·​scripts,​·​the·​file·​permissions,​·​and·​the·​runlevels·​you're·​looking·​at.​·​Try·​to·​run·​the·​control·​script·​from·​the·​command·​line,​·​e.​g.​·​<span·​class="command"><stro​ng>refdbctl·​start</​strong></​span>,​·​to·​distinguish·​between·​general·​setup·​problems·​and·​init-​related·​setup·​problems.​</​p></​div><div·​class="sect4"·​title="BSD-​style"><div·​class="titlepage"><di​v><div><h5·​class="title"><a·​id="idp59784376"></​a>BSD-​style</​h5></​div></​div></​div><p>The·​following·​procedure·​describes·​the·​installation·​on·​a··​✂24 »       ​······​</​p></​li><li·​class="step"·​title="Step·​5"><p>Review·​the·​settings·​in·​the·​script·​<code·​class="filename">refd​bctl</​code>·​which·​by·​default·​is·​installed·​in·​<code·​class="filename">/​usr/​local/​bin/​</​code>.​·​Most·​likely·​the·​script·​was·​properly·​customized·​for·​your·​system·​in·​the·​build·​step·​so·​you·​don't·​have·​to·​change·​anything.​</​p></​li></​ol></​div><p>When·​you·​boot,​·​halt,​·​or·​reboot·​the·​system·​you·​should·​see·​messages·​on·​the·​screen·​telling·​you·​that·​the·​daemon·​has·​been·​started·​or·​stopped·​successfully.​·​If·​you·​don't,​·​please·​check·​again·​all·​paths·​in·​the·​scripts,​·​the·​file·​permissions,​·​and·​the·​runlevels·​you're·​looking·​at.​·​Try·​to·​run·​the·​control·​script·​from·​the·​command·​line,​·​e.​g.​·​<span·​class="command"><stro​ng>refdbctl·​start</​strong></​span>,​·​to·​distinguish·​between·​general·​setup·​problems·​and·​init-​related·​setup·​problems.​</​p></​div><div·​class="sect4"·​title="BSD-​style"><div·​class="titlepage"><di​v><div><h5·​class="title"><a·​id="idp59763896"></​a>BSD-​style</​h5></​div></​div></​div><p>The·​following·​procedure·​describes·​the·​installation·​on·​a··​✂
25 »       ​····​<code·​class="prompt">#~·​</​code>25 »       ​····​<code·​class="prompt">#~·​</​code>
26 »       ​····​<strong·​class="userinput"><co​de>.​/​configure·​-​-​sysconfdir=/​etc·​\26 »       ​····​<strong·​class="userinput"><co​de>.​/​configure·​-​-​sysconfdir=/​etc·​\
27 »       ​····​-​-​with-​docbook-​xsl=/​usr/​share/​sgml/​docbook/​stylesheet/​xsl/​nwalsh·​\27 »       ​····​-​-​with-​docbook-​xsl=/​usr/​share/​sgml/​docbook/​stylesheet/​xsl/​nwalsh·​\
28 »       ​····​-​-​with-​tei-​xsl=/​usr/​local/​lib/​sgml/​stylesheet/​xsl</​code></​strong>28 »       ​····​-​-​with-​tei-​xsl=/​usr/​local/​lib/​sgml/​stylesheet/​xsl</​code></​strong>
29 »       ​··​</​pre></​div></​div><div·​class="sect3"·​title="FreeBSD"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59802808"></​a>FreeBSD</​h4></​div></​div></​div><p>The·​BSD·​version·​of·​<span·​class="command"><stro​ng>make</​strong></​span>·​cannot·​handle·​the·​autotools-​generated·​Makefiles·​correctly.​·​Use·​gmake·​instead,​·​and·​set·​CFLAGS=-​I/​usr/​local/​include·​during·​the·​configuration·​step.​·​The·​full·​configure·​command,​·​using·​the·​default·​installation·​paths·​for·​the·​accessory·​files·​and·​programs,​·​looks·​like·​this:​</​p><pre·​class="screen">29 »       ​··​</​pre></​div></​div><div·​class="sect3"·​title="FreeBSD"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59782328"></​a>FreeBSD</​h4></​div></​div></​div><p>The·​BSD·​version·​of·​<span·​class="command"><stro​ng>make</​strong></​span>·​cannot·​handle·​the·​autotools-​generated·​Makefiles·​correctly.​·​Use·​gmake·​instead,​·​and·​set·​CFLAGS=-​I/​usr/​local/​include·​during·​the·​configuration·​step.​·​The·​full·​configure·​command,​·​using·​the·​default·​installation·​paths·​for·​the·​accessory·​files·​and·​programs,​·​looks·​like·​this:​</​p><pre·​class="screen">
30 »       ​··​<code·​class="prompt">#~·​</​code>30 »       ​··​<code·​class="prompt">#~·​</​code>
31 »       ​··​<strong·​class="userinput"><co​de>CFLAGS=-​I/​usr/​local/​include·​.​/​configure·​-​-​with-​expat-​lib=/​usr/​local/​lib·​\31 »       ​··​<strong·​class="userinput"><co​de>CFLAGS=-​I/​usr/​local/​include·​.​/​configure·​-​-​with-​expat-​lib=/​usr/​local/​lib·​\
32 »       ​··​-​-​with-​classpath-​root=/​usr/​local/​share/​java/​classes·​</​code></​strong>32 »       ​··​-​-​with-​classpath-​root=/​usr/​local/​share/​java/​classes·​</​code></​strong>
33 »       ​</​pre><p>The·​shared·​data·​end·​up·​in·​<code·​class="filename">/​usr/​local/​share/​refdb</​code>,​·​the·​configuration·​files·​will·​be·​in·​<code·​class="filename">/​usr/​local/​etc/​refdb</​code>.​</​p></​div><div·​class="sect3"·​title="NetBSD"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59828152"></​a>NetBSD</​h4></​div></​div></​div><p>The·​BSD·​version·​of·​<span·​class="command"><stro​ng>make</​strong></​span>·​cannot·​handle·​the·​autotools-​generated·​Makefiles·​correctly.​·​Use·​gmake·​instead,​·​and·​set·​the·​following·​environment·​variables·​before·​running·​<span·​class="command"><stro​ng>.​/​configure</​strong></​span>:​</​p><pre·​class="screen">33 »       ​</​pre><p>The·​shared·​data·​end·​up·​in·​<code·​class="filename">/​usr/​local/​share/​refdb</​code>,​·​the·​configuration·​files·​will·​be·​in·​<code·​class="filename">/​usr/​local/​etc/​refdb</​code>.​</​p></​div><div·​class="sect3"·​title="NetBSD"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59787192"></​a>NetBSD</​h4></​div></​div></​div><p>The·​BSD·​version·​of·​<span·​class="command"><stro​ng>make</​strong></​span>·​cannot·​handle·​the·​autotools-​generated·​Makefiles·​correctly.​·​Use·​gmake·​instead,​·​and·​set·​the·​following·​environment·​variables·​before·​running·​<span·​class="command"><stro​ng>.​/​configure</​strong></​span>:​</​p><pre·​class="screen">
34 »       ​··​<code·​class="prompt">#~·​</​code>34 »       ​··​<code·​class="prompt">#~·​</​code>
35 »       ​··​<strong·​class="userinput"><co​de>setenv·​CFLAGS·​"-​I/​usr/​pkg/​include·​-​I/​usr/​local/​include·​-​L/​usr/​pkg/​lib"</​code></​strong>35 »       ​··​<strong·​class="userinput"><co​de>setenv·​CFLAGS·​"-​I/​usr/​pkg/​include·​-​I/​usr/​local/​include·​-​L/​usr/​pkg/​lib"</​code></​strong>
36 »       ​</​pre><pre·​class="screen">36 »       ​</​pre><pre·​class="screen">
37 »       ​··​<code·​class="prompt">#~·​</​code>37 »       ​··​<code·​class="prompt">#~·​</​code>
38 »       ​··​<strong·​class="userinput"><co​de>setenv·​LDFLAGS·​"-​L/​usr/​pkg/​lib··​-​R/​usr/​pkg/​lib·​-​R/​usr/​pkg/​lib/​mysql"</​code></​strong>38 »       ​··​<strong·​class="userinput"><co​de>setenv·​LDFLAGS·​"-​L/​usr/​pkg/​lib··​-​R/​usr/​pkg/​lib·​-​R/​usr/​pkg/​lib/​mysql"</​code></​strong>
39 »       ​</​pre><pre·​class="screen">39 »       ​</​pre><pre·​class="screen">
40 »       ​··​<code·​class="prompt">#~·​</​code>40 »       ​··​<code·​class="prompt">#~·​</​code>
41 »       ​··​<strong·​class="userinput"><co​de>.​/​configure·​-​-​with-​mysqlclient-​lib=/​usr/​pkg/​lib/​mysql·​-​-​with-​btparse-​lib=/​usr/​local/​lib·​-​-​prefix=/​usr/​pkg</​code></​strong>41 »       ​··​<strong·​class="userinput"><co​de>.​/​configure·​-​-​with-​mysqlclient-​lib=/​usr/​pkg/​lib/​mysql·​-​-​with-​btparse-​lib=/​usr/​local/​lib·​-​-​prefix=/​usr/​pkg</​code></​strong>
42 »       ​</​pre><p>Use·​additional·​options·​as·​needed.​·​The·​shared·​data·​will·​end·​up·​in·​<code·​class="filename">/​usr/​pkg/​share/​refdb</​code>,​·​the·​configuration·​files·​go·​to·​<code·​class="filename">/​usr/​pkg/​etc/​refdb</​code>.​</​p></​div><div·​class="sect3"·​title="Solaris"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59836600"></​a>Solaris</​h4></​div></​div></​div><p>Both·​the·​standard·​C·​compiler·​and·​the·​standard·​make·​program·​will·​not·​give·​the·​desired·​results·​when·​building·​RefDB.​·​Use·​gcc·​and·​gmake·​instead.​</​p></​div><div·​class="sect3"·​title="OSX"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59837752"></​a>OSX</​h4></​div></​div></​div><p>Use·​<a·​class="ulink"·​href="http:​/​/​fink.​sourceforge.​net"·​target="_top">fink</​a>·​to·​conveniently·​install·​all·​the·​additional·​software·​needed.​·​Then·​help·​<span·​class="command"><stro​ng>configure</​strong></​span>·​find·​the·​fink-​installed·​packages·​in·​<code·​class="filename">/​sw</​code>·​by·​setting·​the·​following·​environment·​variables:​·​<span·​class="command"><stro​ng>CFLAGS="-​I/​sw/​include"·​LDFL·​✂42 »       ​</​pre><p>Use·​additional·​options·​as·​needed.​·​The·​shared·​data·​will·​end·​up·​in·​<code·​class="filename">/​usr/​pkg/​share/​refdb</​code>,​·​the·​configuration·​files·​go·​to·​<code·​class="filename">/​usr/​pkg/​etc/​refdb</​code>.​</​p></​div><div·​class="sect3"·​title="Solaris"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59816120"></​a>Solaris</​h4></​div></​div></​div><p>Both·​the·​standard·​C·​compiler·​and·​the·​standard·​make·​program·​will·​not·​give·​the·​desired·​results·​when·​building·​RefDB.​·​Use·​gcc·​and·​gmake·​instead.​</​p></​div><div·​class="sect3"·​title="OSX"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59817272"></​a>OSX</​h4></​div></​div></​div><p>Use·​<a·​class="ulink"·​href="http:​/​/​fink.​sourceforge.​net"·​target="_top">fink</​a>·​to·​conveniently·​install·​all·​the·​additional·​software·​needed.​·​Then·​help·​<span·​class="command"><stro​ng>configure</​strong></​span>·​find·​the·​fink-​installed·​packages·​in·​<code·​class="filename">/​sw</​code>·​by·​setting·​the·​following·​environment·​variables:​·​<span·​class="command"><stro​ng>CFLAGS="-​I/​sw/​include"·​LDFL·​✂
/usr/local/share/doc/refdb/ch04s05.html
Offset 1, 9 lines modifiedOffset 1, 9 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Installation·​on·​Windows NT/​2000/​XP</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s04.​html"·​title="Installation·​on·​Linux·​and·​other·​Unix·​variants"·​/​><link·​rel="next"·​href="ch04s06.​html"·​title="Installation·​on·​Windows 95/​98/​ME"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Instal​lation·​on·​Windows NT/​2000/​XP</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s04.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation</​th><td·​w·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Installation·​on·​Windows NT/​2000/​XP</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s04.​html"·​title="Installation·​on·​Linux·​and·​other·​Unix·​variants"·​/​><link·​rel="next"·​href="ch04s06.​html"·​title="Installation·​on·​Windows 95/​98/​ME"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Instal​lation·​on·​Windows NT/​2000/​XP</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s04.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation</​th><td·​w·​✂
3 »       ​····​<span·​class="command"><stro​ng>.​/​configure·​-​-​help</​strong></​span>3 »       ​····​<span·​class="command"><stro​ng>.​/​configure·​-​-​help</​strong></​span>
4 »       ​··​</​p><p>This·​command·​will·​display·​a·​list·​of·​things·​you·​can·​customize.​·​If·​you·​build·​in·​a·​separate·​directory,​·​use·​the·​relative·​path·​to·​<code·​class="filename">conf​igure</​code>·​in·​the·​source·​directory.​·​Some·​important·​options·​are:​</​p><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>All·​paths·​and·​URLs·​in·​the·​following·​options·​should·​be·​entered·​without·​a·​trailing·​slash.​</​p></​div><div·​class="variablelist">​<dl><dt><span·​class="term">-​-​prefix=PREFIX</​span></​dt><dd><p>By·​default,​·​all·​files·​will·​be·​installed·​in·​the·​<code·​class="filename">/​usr/​local</​code>·​tree.​·​Use·​this·​option·​to·​use·​a·​different·​install·​root,​·​e.​g.​·​<code·​class="filename">/​usr</​code>·​or·​<code·​class="filename">/​opt</​code>.​</​p></​dd><dt><span·​class="term">-​-​datadir=DIR</​span></​dt><dd><p>The·​data·​files·​will·​be·​installed·​in·​<code·​class="filename">/​usr/​local/​share/​refdb</​code>·​unless·​you·​use·​this·​option.​·​The·​data·​will·​be·​installed·​in·​the·​directory·​<code·​class="filename">DIR/​refdb</​code>.​·​That·​is,​·​spe·​✂4 »       ​··​</​p><p>This·​command·​will·​display·​a·​list·​of·​things·​you·​can·​customize.​·​If·​you·​build·​in·​a·​separate·​directory,​·​use·​the·​relative·​path·​to·​<code·​class="filename">conf​igure</​code>·​in·​the·​source·​directory.​·​Some·​important·​options·​are:​</​p><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>All·​paths·​and·​URLs·​in·​the·​following·​options·​should·​be·​entered·​without·​a·​trailing·​slash.​</​p></​div><div·​class="variablelist">​<dl><dt><span·​class="term">-​-​prefix=PREFIX</​span></​dt><dd><p>By·​default,​·​all·​files·​will·​be·​installed·​in·​the·​<code·​class="filename">/​usr/​local</​code>·​tree.​·​Use·​this·​option·​to·​use·​a·​different·​install·​root,​·​e.​g.​·​<code·​class="filename">/​usr</​code>·​or·​<code·​class="filename">/​opt</​code>.​</​p></​dd><dt><span·​class="term">-​-​datadir=DIR</​span></​dt><dd><p>The·​data·​files·​will·​be·​installed·​in·​<code·​class="filename">/​usr/​local/​share/​refdb</​code>·​unless·​you·​use·​this·​option.​·​The·​data·​will·​be·​installed·​in·​the·​directory·​<code·​class="filename">DIR/​refdb</​code>.​·​That·​is,​·​spe·​✂
5 »       ​····​<code·​class="prompt">$~·​</​code>5 »       ​····​<code·​class="prompt">$~·​</​code>
6 »       ​····​<strong·​class="userinput"><co​de>.​/​configure·​-​-​with-​refdb-​url=http:​/​/​yourbox.​com/​refdb·​-​-​with-​db-​server=pgsql·​-​-​with-​var-​dir=/​var/​run·​\6 »       ​····​<strong·​class="userinput"><co​de>.​/​configure·​-​-​with-​refdb-​url=http:​/​/​yourbox.​com/​refdb·​-​-​with-​db-​server=pgsql·​-​-​with-​var-​dir=/​var/​run·​\
7 »       ​····​-​-​with-​log-​dir=/​var/​log·​-​-​with-​libdbi-​dir=/​uar/​local/​lib·​-​-​with-​docbook-​xsl=/​usr/​local/​share/​sgml/​stylesheets/​docbook·​\7 »       ​····​-​-​with-​log-​dir=/​var/​log·​-​-​with-​libdbi-​dir=/​uar/​local/​lib·​-​-​with-​docbook-​xsl=/​usr/​local/​share/​sgml/​stylesheets/​docbook·​\
8 »       ​····​-​-​with-​tei-​xsl=/​usr/​local/​share/​xsl/​tei</​code></​strong>8 »       ​····​-​-​with-​tei-​xsl=/​usr/​local/​share/​xsl/​tei</​code></​strong>
9 »       ​··​</​pre></​li><li·​class="step"·​title="Step·​5"><p>Run·​<span·​class="command"><stro​ng>make</​strong></​span>.​·​This·​will·​create·​the·​executables·​and·​adapt·​scripts·​and·​other·​files·​to·​your·​local·​installation.​</​p></​li><li·​class="step"·​title="Step·​6"><p><span·​class="command"><stro​ng>make·​install</​strong></​span>·​will·​copy·​the·​application·​server·​and·​the·​clients·​to·​<code·​class="filename">/​usr/​local/​bin</​code>·​and·​the·​data·​files·​to·​<code·​class="filename">/​usr/​local/​share/​refdb</​code>·​unless·​you·​chose·​different·​directories·​in·​the·​configure·​step.​</​p></​li><li·​class="step"·​title="Step·​7"><p>To·​finish·​the·​installation,​·​please·​follow·​the·​instructions·​in·​the·​section·​<a·​class="link"·​href="ch04s08.​html"·​title="Finishing·​the·​RefDB·​installation">Finishi​ng·​the·​RefDB·​installation</​a>·​below.​</​p></​li></​ol></​div><p>Now·​you·​have·​everything·​in·​place·​to·​use·​the·​RefDB·​clients·​and·​the·​application·​server·​from·​the·​command·​line.​·​To·​install·​the·​application·​server·​as·​a·​service,​·​the·​following·​additional·​steps·​are·​necessary:​</​p><div·​class="procedure">·​✂9 »       ​··​</​pre></​li><li·​class="step"·​title="Step·​5"><p>Run·​<span·​class="command"><stro​ng>make</​strong></​span>.​·​This·​will·​create·​the·​executables·​and·​adapt·​scripts·​and·​other·​files·​to·​your·​local·​installation.​</​p></​li><li·​class="step"·​title="Step·​6"><p><span·​class="command"><stro​ng>make·​install</​strong></​span>·​will·​copy·​the·​application·​server·​and·​the·​clients·​to·​<code·​class="filename">/​usr/​local/​bin</​code>·​and·​the·​data·​files·​to·​<code·​class="filename">/​usr/​local/​share/​refdb</​code>·​unless·​you·​chose·​different·​directories·​in·​the·​configure·​step.​</​p></​li><li·​class="step"·​title="Step·​7"><p>To·​finish·​the·​installation,​·​please·​follow·​the·​instructions·​in·​the·​section·​<a·​class="link"·​href="ch04s08.​html"·​title="Finishing·​the·​RefDB·​installation">Finishi​ng·​the·​RefDB·​installation</​a>·​below.​</​p></​li></​ol></​div><p>Now·​you·​have·​everything·​in·​place·​to·​use·​the·​RefDB·​clients·​and·​the·​application·​server·​from·​the·​command·​line.​·​To·​install·​the·​application·​server·​as·​a·​service,​·​the·​following·​additional·​steps·​are·​necessary:​</​p><div·​class="procedure">·​✂
/usr/local/share/doc/refdb/ch04s06.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Installation·​on·​Windows 95/​98/​ME</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s05.​html"·​title="Installation·​on·​Windows NT/​2000/​XP"·​/​><link·​rel="next"·​href="ch04s07.​html"·​title="Other·​operating·​systems"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Instal​lation·​on·​Windows 95/​98/​ME</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation</​th><td·​width="20%"·​align="right"·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Installation·​on·​Windows 95/​98/​ME</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s05.​html"·​title="Installation·​on·​Windows NT/​2000/​XP"·​/​><link·​rel="next"·​href="ch04s07.​html"·​title="Other·​operating·​systems"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Instal​lation·​on·​Windows 95/​98/​ME</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation</​th><td·​width="20%"·​align="right"·​✂
/usr/local/share/doc/refdb/ch04s07.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Other·​operating·​systems</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s06.​html"·​title="Installation·​on·​Windows 95/​98/​ME"·​/​><link·​rel="next"·​href="ch04s08.​html"·​title="Finishing·​the·​RefDB·​installation"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Other·​operating·​systems</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s06.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation</​th><td·​width="20%"·​align="right"> <a·​access·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Other·​operating·​systems</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s06.​html"·​title="Installation·​on·​Windows 95/​98/​ME"·​/​><link·​rel="next"·​href="ch04s08.​html"·​title="Finishing·​the·​RefDB·​installation"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Other·​operating·​systems</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s06.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation</​th><td·​width="20%"·​align="right"> <a·​access·​✂
/usr/local/share/doc/refdb/ch04s08.html
Offset 1, 9 lines modifiedOffset 1, 9 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Finishing·​the·​RefDB·​installation</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s07.​html"·​title="Other·​operating·​systems"·​/​><link·​rel="next"·​href="ch04s09.​html"·​title="Testing·​your·​installation"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Finish​ing·​the·​RefDB·​installation</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s07.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation</​th><td·​width="20%"·​align="right"> <a·​acce·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Finishing·​the·​RefDB·​installation</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch04.​html"·​title="Chapter 4.​ Installation"·​/​><link·​rel="prev"·​href="ch04s07.​html"·​title="Other·​operating·​systems"·​/​><link·​rel="next"·​href="ch04s09.​html"·​title="Testing·​your·​installation"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Finish​ing·​the·​RefDB·​installation</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s07.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 4.​ Installation</​th><td·​width="20%"·​align="right"> <a·​acce·​✂
3 »       ​····​<code·​class="prompt">~$·​</​code>3 »       ​····​<code·​class="prompt">~$·​</​code>
4 »       ​····​<strong·​class="userinput"><co​de>refdbd·​-​a·​-​u·​username·​-​w·​password</​code></​strong>4 »       ​····​<strong·​class="userinput"><co​de>refdbd·​-​a·​-​u·​username·​-​w·​password</​code></​strong>
5 »       ​··​</​pre><p>Specify·​the·​username·​and·​password·​of·​your·​database·​administrator·​account.​</​p><p>If·​the·​default·​setup·​described·​above·​does·​not·​suit·​your·​needs,​·​please·​use·​the·​following·​procedure·​instead·​to·​set·​up·​the·​main·​database.​</​p><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>If·​<code·​class="filename">mysq​ld</​code>·​(the·​MySQL·​database·​server)​·​is·​installed·​on·​a·​remote·​box·​or·​if·​the·​security·​settings·​require·​it,​·​you·​may·​have·​to·​use·​the·​<code·​class="option">-​h·​<em·​class="replaceable"><​code>hostname</​code></​em></​code>·​and/​or·​the·​<code·​class="option">-​u·​<em·​class="replaceable"><​code>username</​code></​em></​code>/​<code·​class="option">-​p·​<em·​class="replaceable"><​code>password</​code></​em></​code>·​options·​to·​run·​the·​<code·​class="filename">mysq​l</​code>·​client·​as·​shown·​below·​(most·​fresh·​MySQL·​installations·​use·​"root"·​with·​no·​password·​as·​the·​default·​database·​administrator)​.​·​<code·​class="filename">mysq​ld</​code>·​needs·​to·​be·​up·​and·​running·​and·​you·​need·​the·​appropri·​✂5 »       ​··​</​pre><p>Specify·​the·​username·​and·​password·​of·​your·​database·​administrator·​account.​</​p><p>If·​the·​default·​setup·​described·​above·​does·​not·​suit·​your·​needs,​·​please·​use·​the·​following·​procedure·​instead·​to·​set·​up·​the·​main·​database.​</​p><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>If·​<code·​class="filename">mysq​ld</​code>·​(the·​MySQL·​database·​server)​·​is·​installed·​on·​a·​remote·​box·​or·​if·​the·​security·​settings·​require·​it,​·​you·​may·​have·​to·​use·​the·​<code·​class="option">-​h·​<em·​class="replaceable"><​code>hostname</​code></​em></​code>·​and/​or·​the·​<code·​class="option">-​u·​<em·​class="replaceable"><​code>username</​code></​em></​code>/​<code·​class="option">-​p·​<em·​class="replaceable"><​code>password</​code></​em></​code>·​options·​to·​run·​the·​<code·​class="filename">mysq​l</​code>·​client·​as·​shown·​below·​(most·​fresh·​MySQL·​installations·​use·​"root"·​with·​no·​password·​as·​the·​default·​database·​administrator)​.​·​<code·​class="filename">mysq​ld</​code>·​needs·​to·​be·​up·​and·​running·​and·​you·​need·​the·​appropri·​✂
6 »       ​»       ​<code·​class="prompt">~$·​</​code>6 »       ​»       ​<code·​class="prompt">~$·​</​code>
7 »       ​»       ​<strong·​class="userinput"><co​de>mysql·​-​u·​root·​-​e·​"CREATE·​DATABASE·​refdb"</​code></​strong>7 »       ​»       ​<strong·​class="userinput"><co​de>mysql·​-​u·​root·​-​e·​"CREATE·​DATABASE·​refdb"</​code></​strong>
8 »       ​······​</​pre></​li><li·​class="listitem"><p>T​hen·​create·​the·​tables·​and·​fill·​in·​the·​data.​·​For·​MySQL·​older·​than·​4.​1,​·​run:​</​p><pre·​class="screen">8 »       ​······​</​pre></​li><li·​class="listitem"><p>T​hen·​create·​the·​tables·​and·​fill·​in·​the·​data.​·​For·​MySQL·​older·​than·​4.​1,​·​run:​</​p><pre·​class="screen">
9 »       ​»       ​<code·​class="prompt">~$·​</​code>9 »       ​»       ​<code·​class="prompt">~$·​</​code>
/usr/local/share/doc/refdb/ch05.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 5.​ refdbd·​administration</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt02.​html"·​title="Part II.​ Administrator·​manual"·​/​><link·​rel="prev"·​href="ch04s11.​html"·​title="Install·​the·​PHP·​interface"·​/​><link·​rel="next"·​href="ch05s02.​html"·​title="Delete·​a·​database"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 5.​ refdbd·​administration</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s11.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​I.​ Administrator·​manual</​th><td·​width="20%"·​align="right"> <·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 5.​ refdbd·​administration</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt02.​html"·​title="Part II.​ Administrator·​manual"·​/​><link·​rel="prev"·​href="ch04s11.​html"·​title="Install·​the·​PHP·​interface"·​/​><link·​rel="next"·​href="ch05s02.​html"·​title="Delete·​a·​database"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 5.​ refdbd·​administration</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch04s11.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​I.​ Administrator·​manual</​th><td·​width="20%"·​align="right"> <·​✂
/usr/local/share/doc/refdb/ch05s03.html
Offset 1, 8 lines modifiedOffset 1, 8 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Add·​or·​remove·​a·​user</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s02.​html"·​title="Delete·​a·​database"·​/​><link·​rel="next"·​href="ch05s04.​html"·​title="Configure·​the·​application·​server"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Add·​or·​remove·​a·​user</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​width="20%"·​align="right"> <a·​accesskey·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Add·​or·​remove·​a·​user</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s02.​html"·​title="Delete·​a·​database"·​/​><link·​rel="next"·​href="ch05s04.​html"·​title="Configure·​the·​application·​server"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Add·​or·​remove·​a·​user</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​width="20%"·​align="right"> <a·​accesskey·​✂
3 local·​refdb····························​crypt3 local·​refdb····························​crypt
4 local·​refs······························​crypt4 local·​refs······························​crypt
  
5 host··​refdb··​192.​168.​1.​0·​255.​255.​255.​0·​crypt5 host··​refdb··​192.​168.​1.​0·​255.​255.​255.​0·​crypt
6 host··​refs····​192.​168.​1.​0·​255.​255.​255.​0·​crypt6 host··​refs····​192.​168.​1.​0·​255.​255.​255.​0·​crypt
7 »       ​</​pre><p>The·​default·​<code·​class="filename">pg_h​ba.​conf</​code>·​file·​allows·​local·​access·​to·​all·​databases·​without·​password·​protection.​·​This·​may·​not·​be·​what·​you·​want.​·​The·​file·​contains·​a·​bunch·​of·​helpful·​comments,​·​though.​·​You·​may·​also·​want·​to·​peruse·​the·​PostgreSQL·​documentation·​for·​more·​information·​about·​host-​based·​access·​control.​</​p></​div></​div><div·​class="sect2"·​title="Remove·​users"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​id="idp59249464"></​a>Remove·​users</​h3></​div></​div></​div><p>This·​is·​done·​with·​the·​<a·​class="link"·​href="re06.​html#app-​a-​command-​deleteuser"·​title="deleteuser">de​leteuser</​a>·​command.​·​The·​access·​rights·​will·​be·​revoked·​for·​the·​specified·​username·​and·​database.​·​No·​other·​access·​rights·​will·​be·​modified.​·​The·​following·​command·​will·​revoke·​the·​access·​rights·​of·​user·​"jack"·​on·​the·​database·​"foo".​</​p><pre·​class="screen"><code·​class="prompt">refdba​:​·​</​code>deleteuser·​-​d·​foo·​jack</​pre><p>Keep·​in·​mind·​that·​user·​"jack"·​still·​can·​access·​the·​refdb·​main·​database·​<code·​class="filename">refd​b</​code·​✂7 »       ​</​pre><p>The·​default·​<code·​class="filename">pg_h​ba.​conf</​code>·​file·​allows·​local·​access·​to·​all·​databases·​without·​password·​protection.​·​This·​may·​not·​be·​what·​you·​want.​·​The·​file·​contains·​a·​bunch·​of·​helpful·​comments,​·​though.​·​You·​may·​also·​want·​to·​peruse·​the·​PostgreSQL·​documentation·​for·​more·​information·​about·​host-​based·​access·​control.​</​p></​div></​div><div·​class="sect2"·​title="Remove·​users"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​id="idp59294520"></​a>Remove·​users</​h3></​div></​div></​div><p>This·​is·​done·​with·​the·​<a·​class="link"·​href="re06.​html#app-​a-​command-​deleteuser"·​title="deleteuser">de​leteuser</​a>·​command.​·​The·​access·​rights·​will·​be·​revoked·​for·​the·​specified·​username·​and·​database.​·​No·​other·​access·​rights·​will·​be·​modified.​·​The·​following·​command·​will·​revoke·​the·​access·​rights·​of·​user·​"jack"·​on·​the·​database·​"foo".​</​p><pre·​class="screen"><code·​class="prompt">refdba​:​·​</​code>deleteuser·​-​d·​foo·​jack</​pre><p>Keep·​in·​mind·​that·​user·​"jack"·​still·​can·​access·​the·​refdb·​main·​database·​<code·​class="filename">refd​b</​code·​✂
/usr/local/share/doc/refdb/ch05s04.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Configure·​the·​application·​server</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s03.​html"·​title="Add·​or·​remove·​a·​user"·​/​><link·​rel="next"·​href="ch05s05.​html"·​title="Add,​·​edit,​·​or·​delete·​bibliography·​styles"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Config​ure·​the·​application·​server</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s03.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​widt·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Configure·​the·​application·​server</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s03.​html"·​title="Add·​or·​remove·​a·​user"·​/​><link·​rel="next"·​href="ch05s05.​html"·​title="Add,​·​edit,​·​or·​delete·​bibliography·​styles"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Config​ure·​the·​application·​server</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s03.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​widt·​✂
/usr/local/share/doc/refdb/ch05s06.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Logging·​data</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s05.​html"·​title="Add,​·​edit,​·​or·​delete·​bibliography·​styles"·​/​><link·​rel="next"·​href="ch05s07.​html"·​title="Security·​issues"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Loggin​g·​data</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href=·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Logging·​data</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s05.​html"·​title="Add,​·​edit,​·​or·​delete·​bibliography·​styles"·​/​><link·​rel="next"·​href="ch05s07.​html"·​title="Security·​issues"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Loggin​g·​data</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href=·​✂
/usr/local/share/doc/refdb/ch05s07.html
Offset 1, 8 lines modifiedOffset 1, 8 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Security·​issues</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s06.​html"·​title="Logging·​data"·​/​><link·​rel="next"·​href="ch05s08.​html"·​title="How·​to·​run·​several·​refdb·​instances"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Securi​ty·​issues</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s06.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href="ch·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Security·​issues</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s06.​html"·​title="Logging·​data"·​/​><link·​rel="next"·​href="ch05s08.​html"·​title="How·​to·​run·​several·​refdb·​instances"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Securi​ty·​issues</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s06.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href="ch·​✂
3 local·​refdb····························​crypt3 local·​refdb····························​crypt
4 local·​refs······························​crypt4 local·​refs······························​crypt
  
5 host··​refdb··​192.​168.​1.​0·​255.​255.​255.​0·​crypt5 host··​refdb··​192.​168.​1.​0·​255.​255.​255.​0·​crypt
6 host··​refs····​192.​168.​1.​0·​255.​255.​255.​0·​crypt6 host··​refs····​192.​168.​1.​0·​255.​255.​255.​0·​crypt
7 »       ​····​</​pre><p>As·​mentioned·​previously,​·​only·​the·​host·​where·​refdbd·​runs·​is·​relevant·​for·​the·​host·​or·​network·​entries·​in·​the·​configuration·​file.​</​p><p>Make·​sure·​to·​read·​the·​PostgreSQL·​documentation·​to·​get·​your·​access·​control·​right.​</​p><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>Please·​keep·​in·​mind·​that·​<code·​class="filename">post​master</​code>·​(the·​PostgreSQL·​database·​server·​parent·​process)​·​needs·​to·​be·​started·​with·​the·​<code·​class="option">-​i</​code>·​option·​to·​accept·​remote·​connections·​at·​all.​·​Most·​default·​installations·​do·​not·​use·​this·​switch·​to·​increase·​security.​</​p></​div></​li><li·​class="listitem"><p>I​f·​you·​install·​and·​run·​PostgreSQL·​yourself,​·​you·​should·​not·​use·​the·​default·​database·​administrator·​account.​·​The·​name·​(pgsql)​·​is·​widely·​known·​and·​by·​default·​this·​account·​is·​not·​password-​protected.​·​To·​make·​your·​database·​server·​secure,​·​please·​create·​a·​new·​database·​administrator·​account·​with·​a·​different·​name·​and·​specify·​a·​password.​</​p></​li></​ul></​div></​div>·​✂7 »       ​····​</​pre><p>As·​mentioned·​previously,​·​only·​the·​host·​where·​refdbd·​runs·​is·​relevant·​for·​the·​host·​or·​network·​entries·​in·​the·​configuration·​file.​</​p><p>Make·​sure·​to·​read·​the·​PostgreSQL·​documentation·​to·​get·​your·​access·​control·​right.​</​p><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>Please·​keep·​in·​mind·​that·​<code·​class="filename">post​master</​code>·​(the·​PostgreSQL·​database·​server·​parent·​process)​·​needs·​to·​be·​started·​with·​the·​<code·​class="option">-​i</​code>·​option·​to·​accept·​remote·​connections·​at·​all.​·​Most·​default·​installations·​do·​not·​use·​this·​switch·​to·​increase·​security.​</​p></​div></​li><li·​class="listitem"><p>I​f·​you·​install·​and·​run·​PostgreSQL·​yourself,​·​you·​should·​not·​use·​the·​default·​database·​administrator·​account.​·​The·​name·​(pgsql)​·​is·​widely·​known·​and·​by·​default·​this·​account·​is·​not·​password-​protected.​·​To·​make·​your·​database·​server·​secure,​·​please·​create·​a·​new·​database·​administrator·​account·​with·​a·​different·​name·​and·​specify·​a·​password.​</​p></​li></​ul></​div></​div>·​✂
/usr/local/share/doc/refdb/ch05s08.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>How·​to·​run·​several·​refdb·​instances</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s07.​html"·​title="Security·​issues"·​/​><link·​rel="next"·​href="ch05s09.​html"·​title="Backup·​your·​data"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">How·​to·​run·​several·​refdb·​instances</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s07.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​width="20%"·​align="right"> <a·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>How·​to·​run·​several·​refdb·​instances</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s07.​html"·​title="Security·​issues"·​/​><link·​rel="next"·​href="ch05s09.​html"·​title="Backup·​your·​data"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">How·​to·​run·​several·​refdb·​instances</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s07.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​width="20%"·​align="right"> <a·​✂
/usr/local/share/doc/refdb/ch05s09.html
Offset 1, 12 lines modifiedOffset 1, 12 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Backup·​your·​data</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s08.​html"·​title="How·​to·​run·​several·​refdb·​instances"·​/​><link·​rel="next"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Backup​·​your·​data</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s08.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"··​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Backup·​your·​data</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch05.​html"·​title="Chapter 5.​ refdbd·​administration"·​/​><link·​rel="prev"·​href="ch05s08.​html"·​title="How·​to·​run·​several·​refdb·​instances"·​/​><link·​rel="next"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Backup​·​your·​data</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch05s08.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 5.​ refdbd·​administration</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"··​✂
3 »       ​<code·​class="prompt">refdbc​:​·​</​code>3 »       ​<code·​class="prompt">refdbc​:​·​</​code>
4 »       ​<strong·​class="userinput"><co​de>getref·​-​t·​risx·​-​s·​NOHOLES·​-​o·​all.​ris·​:​ID:​&gt;​0</​code></​strong>4 »       ​<strong·​class="userinput"><co​de>getref·​-​t·​risx·​-​s·​NOHOLES·​-​o·​all.​ris·​:​ID:​&gt;​0</​code></​strong>
5 ······​</​pre><p>The·​<code·​class="option">-​s·​NOHOLES</​code>·​option·​will·​dump·​skeleton·​references·​for·​references·​that·​you·​deleted·​from·​the·​database.​·​This·​simplifies·​re-​creating·​the·​same·​ID·​values·​in·​a·​new·​database.​</​p></​div><div·​class="sect2"·​title="Creating·​a·​SQL·​dump"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​id="idp59377080"></​a>Creating·​a·​SQL·​dump</​h3></​div></​div></​div><p>This·​is·​best·​done·​with·​the·​command·​line·​tools·​shipped·​with·​you·​database·​server.​·​You·​should·​consult·​the·​manual·​of·​your·​database·​server,​·​but·​the·​following·​commands·​should·​be·​all·​it·​takes:​</​p><p>If·​you·​run·​MySQL·​as·​your·​database·​server,​·​run:​</​p><pre·​class="screen">5 ······​</​pre><p>The·​<code·​class="option">-​s·​NOHOLES</​code>·​option·​will·​dump·​skeleton·​references·​for·​references·​that·​you·​deleted·​from·​the·​database.​·​This·​simplifies·​re-​creating·​the·​same·​ID·​values·​in·​a·​new·​database.​</​p></​div><div·​class="sect2"·​title="Creating·​a·​SQL·​dump"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​id="idp59024824"></​a>Creating·​a·​SQL·​dump</​h3></​div></​div></​div><p>This·​is·​best·​done·​with·​the·​command·​line·​tools·​shipped·​with·​you·​database·​server.​·​You·​should·​consult·​the·​manual·​of·​your·​database·​server,​·​but·​the·​following·​commands·​should·​be·​all·​it·​takes:​</​p><p>If·​you·​run·​MySQL·​as·​your·​database·​server,​·​run:​</​p><pre·​class="screen">
6 »       ​<code·​class="prompt">$·​</​code>6 »       ​<code·​class="prompt">$·​</​code>
7 »       ​<strong·​class="userinput"><co​de>mysqldump·​-​u·​root·​-​p·​-​-​opt·​dbname·​&gt;​·​dbname.​dump</​code></​strong>7 »       ​<strong·​class="userinput"><co​de>mysqldump·​-​u·​root·​-​p·​-​-​opt·​dbname·​&gt;​·​dbname.​dump</​code></​strong>
8 ······​</​pre><p>This·​assumes·​that·​"root"·​is·​the·​name·​of·​your·​database·​administrator·​account·​and·​"dbname"·​is·​the·​name·​of·​your·​database.​</​p><p>If·​you·​run·​PostgreSQL·​instead,​·​use·​this·​command:​</​p><pre·​class="screen">8 ······​</​pre><p>This·​assumes·​that·​"root"·​is·​the·​name·​of·​your·​database·​administrator·​account·​and·​"dbname"·​is·​the·​name·​of·​your·​database.​</​p><p>If·​you·​run·​PostgreSQL·​instead,​·​use·​this·​command:​</​p><pre·​class="screen">
9 »       ​<code·​class="prompt">$·​</​code>9 »       ​<code·​class="prompt">$·​</​code>
10 »       ​<strong·​class="userinput"><co​de>pg_dump·​-​u·​pgsql·​-​C·​dbname·​&gt;​·​dbname.​dump</​code></​strong>10 »       ​<strong·​class="userinput"><co​de>pg_dump·​-​u·​pgsql·​-​C·​dbname·​&gt;​·​dbname.​dump</​code></​strong>
11 ······​</​pre><p>This·​assumes·​that·​"pgsql"·​is·​the·​name·​of·​your·​database·​administrator·​account·​and·​"dbname"·​is·​the·​name·​of·​your·​database.​</​p><p>To·​restore·​a·​database·​from·​a·​dump,​·​use·​the·​command·​line·​clients·​shipped·​with·​your·​database·​server.​·​For·​MySQL,​·​the·​required·​sequence·​is:​</​p><pre·​class="screen">11 ······​</​pre><p>This·​assumes·​that·​"pgsql"·​is·​the·​name·​of·​your·​database·​administrator·​account·​and·​"dbname"·​is·​the·​name·​of·​your·​database.​</​p><p>To·​restore·​a·​database·​from·​a·​dump,​·​use·​the·​command·​line·​clients·​shipped·​with·​your·​database·​server.​·​For·​MySQL,​·​the·​required·​sequence·​is:​</​p><pre·​class="screen">
12 »       ​<code·​class="prompt">$·​</​code>12 »       ​<code·​class="prompt">$·​</​code>
/usr/local/share/doc/refdb/ch06.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​><link·​rel="prev"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​><link·​rel="next"·​href="ch06s02.​html"·​title="The·​interactive·​mode·​of·​refdba·​and·​refdbc"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="pt03.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​II.​ User·​man·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​><link·​rel="prev"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​><link·​rel="next"·​href="ch06s02.​html"·​title="The·​interactive·​mode·​of·​refdba·​and·​refdbc"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="pt03.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​II.​ User·​man·​✂
/usr/local/share/doc/refdb/ch06s02.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>The·​interactive·​mode·​of·​refdba·​and·​refdbc</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch06.​html"·​title="Chapter 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients"·​/​><link·​rel="prev"·​href="ch06.​html"·​title="Chapter 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients"·​/​><link·​rel="next"·​href="ch06s03.​html"·​title="The·​non-​interactive·​mode·​of·​refdba·​and·​refdbc"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">The·​interactive·​mode·​of·​refdba·​and·​refdbc</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch06.​html">Prev</​a> </​td><th·​w·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>The·​interactive·​mode·​of·​refdba·​and·​refdbc</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch06.​html"·​title="Chapter 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients"·​/​><link·​rel="prev"·​href="ch06.​html"·​title="Chapter 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients"·​/​><link·​rel="next"·​href="ch06s03.​html"·​title="The·​non-​interactive·​mode·​of·​refdba·​and·​refdbc"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">The·​interactive·​mode·​of·​refdba·​and·​refdbc</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch06.​html">Prev</​a> </​td><th·​w·​✂
/usr/local/share/doc/refdb/ch06s03.html
Offset 1, 5 lines modifiedOffset 1, 5 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>The·​non-​interactive·​mode·​of·​refdba·​and·​refdbc</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch06.​html"·​title="Chapter 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients"·​/​><link·​rel="prev"·​href="ch06s02.​html"·​title="The·​interactive·​mode·​of·​refdba·​and·​refdbc"·​/​><link·​rel="next"·​href="ch06s04.​html"·​title="The·​non-​interactive·​mode·​of·​refdbib"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">The·​non-​interactive·​mode·​of·​refdba·​and·​refdbc</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch06s02.​html">Prev</​a> </​td><th·​width="60·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>The·​non-​interactive·​mode·​of·​refdba·​and·​refdbc</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch06.​html"·​title="Chapter 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients"·​/​><link·​rel="prev"·​href="ch06s02.​html"·​title="The·​interactive·​mode·​of·​refdba·​and·​refdbc"·​/​><link·​rel="next"·​href="ch06s04.​html"·​title="The·​non-​interactive·​mode·​of·​refdbib"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">The·​non-​interactive·​mode·​of·​refdba·​and·​refdbc</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch06s02.​html">Prev</​a> </​td><th·​width="60·​✂
3 »       ​<code·​class="prompt">~$·​</​code>3 »       ​<code·​class="prompt">~$·​</​code>
4 »       ​<strong·​class="userinput"><co​de>refdbc·​-​d·​refs·​-​t·​ris·​-​s·​AB·​-​C·​getref·​:​AU:​=Miller</​code></​strong>4 »       ​<strong·​class="userinput"><co​de>refdbc·​-​d·​refs·​-​t·​ris·​-​s·​AB·​-​C·​getref·​:​AU:​=Miller</​code></​strong>
5 ······​</​pre></​div></​div><div·​class="navfooter"><hr​·​/​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ch06s02.​html">Prev</​a> </​td><td·​width="20%"·​align="center"><a·​accesskey="u"·​href="ch06.​html">Up</​a></​td><td·​width="40%"·​align="right"> <a·​accesskey="n"·​href="ch06s04.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">The·​interactive·​mode·​of·​refdba·​and·​refdbc </​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top"> The·​non-​interactive·​mode·​of·​refdbib</​td></​tr></​table></​div></​body></​html>5 ······​</​pre></​div></​div><div·​class="navfooter"><hr​·​/​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ch06s02.​html">Prev</​a> </​td><td·​width="20%"·​align="center"><a·​accesskey="u"·​href="ch06.​html">Up</​a></​td><td·​width="40%"·​align="right"> <a·​accesskey="n"·​href="ch06s04.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">The·​interactive·​mode·​of·​refdba·​and·​refdbc </​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top"> The·​non-​interactive·​mode·​of·​refdbib</​td></​tr></​table></​div></​body></​html>
/usr/local/share/doc/refdb/ch06s04.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>The·​non-​interactive·​mode·​of·​refdbib</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch06.​html"·​title="Chapter 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients"·​/​><link·​rel="prev"·​href="ch06s03.​html"·​title="The·​non-​interactive·​mode·​of·​refdba·​and·​refdbc"·​/​><link·​rel="next"·​href="ch06s05.​html"·​title="Common·​command-​line·​options·​for·​all·​clients"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">The·​non-​interactive·​mode·​of·​refdbib</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch06s03.​html">Prev</​a> </​td><th·​width="60%"·​align·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>The·​non-​interactive·​mode·​of·​refdbib</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch06.​html"·​title="Chapter 6.​ Overview·​of·​the·​RefDB·​command-​line·​clients"·​/​><link·​rel="prev"·​href="ch06s03.​html"·​title="The·​non-​interactive·​mode·​of·​refdba·​and·​refdbc"·​/​><link·​rel="next"·​href="ch06s05.​html"·​title="Common·​command-​line·​options·​for·​all·​clients"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">The·​non-​interactive·​mode·​of·​refdbib</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch06s03.​html">Prev</​a> </​td><th·​width="60%"·​align·​✂
/usr/local/share/doc/refdb/ch07.html
Offset 1, 14 lines modifiedOffset 1, 14 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 7.​ Data·​input</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​><link·​rel="prev"·​href="ch06s05.​html"·​title="Common·​command-​line·​options·​for·​all·​clients"·​/​><link·​rel="next"·​href="ch07s02.​html"·​title="The·​Emacs·​helpers"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 7.​ Data·​input</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch06s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​II.​ User·​manual</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 7.​ Data·​input</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​><link·​rel="prev"·​href="ch06s05.​html"·​title="Common·​command-​line·​options·​for·​all·​clients"·​/​><link·​rel="next"·​href="ch07s02.​html"·​title="The·​Emacs·​helpers"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 7.​ Data·​input</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch06s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​II.​ User·​manual</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href·​✂
3 TY··​-​·​BOOK·················​<a·​id="type"></​a><img·​src="images/​callouts/​2.​png"·​alt="2"·​border="0"·​/​>·3 TY··​-​·​BOOK·················​<a·​id="type"></​a><img·​src="images/​callouts/​2.​png"·​alt="2"·​border="0"·​/​>·
4 AU··​-​·​Hoenicka,​M.​··········​<a·​id="contents"></​a><img·​src="images/​callouts/​3.​png"·​alt="3"·​border="0"·​/​>4 AU··​-​·​Hoenicka,​M.​··········​<a·​id="contents"></​a><img·​src="images/​callouts/​3.​png"·​alt="3"·​border="0"·​/​>
5 TI··​-​·​The·​RefDB·​manual5 TI··​-​·​The·​RefDB·​manual
6 PY··​-​·​20016 PY··​-​·​2001
7 ER··​-​······················​<a·​id="end"></​a><img·​src="images/​callouts/​4.​png"·​alt="4"·​border="0"·​/​></​pre><div·​class="calloutlist"><​table·​border="0"·​summary="Callout·​list"><tr><td·​width="5%"·​valign="top"·​align="left"><p><a·​href="#newline"><img·​src="images/​callouts/​1.​png"·​alt="1"·​border="0"·​/​></​a>·​</​p></​td><td·​valign="top"·​align="left"><p>This·​is·​the·​empty·​line·​generated·​by·​a·​linefeed·​character·​(0x0A)​·​that·​precedes·​every·​RIS·​citation,​·​even·​at·​the·​start·​of·​a·​RIS·​file.​</​p></​td></​tr><tr><td·​width="5%"·​valign="top"·​align="left"><p><a·​href="#type"><img·​src="images/​callouts/​2.​png"·​alt="2"·​border="0"·​/​></​a>·​</​p></​td><td·​valign="top"·​align="left"><p>This·​is·​the·​mandatory·​first·​tag,​·​the·​type·​specifier.​·​In·​this·​case,​·​we're·​looking·​at·​a·​BOOK·​entry.​</​p></​td></​tr><tr><td·​width="5%"·​valign="top"·​align="left"><p><a·​href="#contents"><img​·​src="images/​callouts/​3.​png"·​alt="3"·​border="0"·​/​></​a>·​</​p></​td><td·​valign="top"·​align="left"><p>This·​and·​the·​following·​lines·​are·​the·​contents·​proper·​of·​the·​citation.​·​All·​additional·​tags·​would·​go·​✂7 ER··​-​······················​<a·​id="end"></​a><img·​src="images/​callouts/​4.​png"·​alt="4"·​border="0"·​/​></​pre><div·​class="calloutlist"><​table·​border="0"·​summary="Callout·​list"><tr><td·​width="5%"·​valign="top"·​align="left"><p><a·​href="#newline"><img·​src="images/​callouts/​1.​png"·​alt="1"·​border="0"·​/​></​a>·​</​p></​td><td·​valign="top"·​align="left"><p>This·​is·​the·​empty·​line·​generated·​by·​a·​linefeed·​character·​(0x0A)​·​that·​precedes·​every·​RIS·​citation,​·​even·​at·​the·​start·​of·​a·​RIS·​file.​</​p></​td></​tr><tr><td·​width="5%"·​valign="top"·​align="left"><p><a·​href="#type"><img·​src="images/​callouts/​2.​png"·​alt="2"·​border="0"·​/​></​a>·​</​p></​td><td·​valign="top"·​align="left"><p>This·​is·​the·​mandatory·​first·​tag,​·​the·​type·​specifier.​·​In·​this·​case,​·​we're·​looking·​at·​a·​BOOK·​entry.​</​p></​td></​tr><tr><td·​width="5%"·​valign="top"·​align="left"><p><a·​href="#contents"><img​·​src="images/​callouts/​3.​png"·​alt="3"·​border="0"·​/​></​a>·​</​p></​td><td·​valign="top"·​align="left"><p>This·​and·​the·​following·​lines·​are·​the·​contents·​proper·​of·​the·​citation.​·​All·​additional·​tags·​would·​go·​✂
8 TY··​-​·​JOUR8 TY··​-​·​JOUR
9 T1··​-​·​T-​lymphocytes·​from·​normal·​human·​peritoneum·​are·​phenotypically·​/​9 T1··​-​·​T-​lymphocytes·​from·​normal·​human·​peritoneum·​are·​phenotypically·​/​
10 different·​from·​their·​counterparts·​in·​peripheral·​blood·​and·​CD3-​·​lymphocyte·​/​10 different·​from·​their·​counterparts·​in·​peripheral·​blood·​and·​CD3-​·​lymphocyte·​/​
11 subsets·​contain·​mRNA·​for·​the·​recombination·​activating·​gene·​RAG-​111 subsets·​contain·​mRNA·​for·​the·​recombination·​activating·​gene·​RAG-​1
12 A1··​-​·​Hartmann,​J.​12 A1··​-​·​Hartmann,​J.​
13 A1··​-​·​Maassen,​V.​13 A1··​-​·​Maassen,​V.​
14 A1··​-​·​Rieber,​P.​14 A1··​-​·​Rieber,​P.​
/usr/local/share/doc/refdb/ch07s02.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>The·​Emacs·​helpers</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch07.​html"·​title="Chapter 7.​ Data·​input"·​/​><link·​rel="prev"·​href="ch07.​html"·​title="Chapter 7.​ Data·​input"·​/​><link·​rel="next"·​href="ch07s03.​html"·​title="Input·​filters"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">The·​Emacs·​helpers</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch07.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 7.​ Data·​input</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href="ch07s03.​html">Next</​a></​td></​tr></​tabl·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>The·​Emacs·​helpers</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch07.​html"·​title="Chapter 7.​ Data·​input"·​/​><link·​rel="prev"·​href="ch07.​html"·​title="Chapter 7.​ Data·​input"·​/​><link·​rel="next"·​href="ch07s03.​html"·​title="Input·​filters"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">The·​Emacs·​helpers</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch07.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 7.​ Data·​input</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href="ch07s03.​html">Next</​a></​td></​tr></​tabl·​✂
/usr/local/share/doc/refdb/ch07s03.html
Offset 1, 9 lines modifiedOffset 1, 9 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Input·​filters</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch07.​html"·​title="Chapter 7.​ Data·​input"·​/​><link·​rel="prev"·​href="ch07s02.​html"·​title="The·​Emacs·​helpers"·​/​><link·​rel="next"·​href="ch07s04.​html"·​title="Writing·​risx·​datasets"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Input·​filters</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch07s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 7.​ Data·​input</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href="ch07s04.​html">Next</​a></​td></​tr></​ta·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Input·​filters</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch07.​html"·​title="Chapter 7.​ Data·​input"·​/​><link·​rel="prev"·​href="ch07s02.​html"·​title="The·​Emacs·​helpers"·​/​><link·​rel="next"·​href="ch07s04.​html"·​title="Writing·​risx·​datasets"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Input·​filters</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch07s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 7.​ Data·​input</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href="ch07s04.​html">Next</​a></​td></​tr></​ta·​✂
3 »       ​··​<a·​class="link"·​href="re17.​html"·​title="refdb_dos2unix​">refdb_dos2unix</​a>3 »       ​··​<a·​class="link"·​href="re17.​html"·​title="refdb_dos2unix​">refdb_dos2unix</​a>
4 »       ​</​span></​dt><dd><p>A·​simple·​(maybe·​<span·​class="emphasis"><em>​too</​em></​span>·​simple)​·​shell·​script·​to·​convert·​text·​files·​like·​RIS·​documents·​from·​DOS-​style·​line·​endings·​to·​Unix-​style·​line·​endings.​·​Most·​RefDB·​tools·​need·​their·​input·​files·​with·​Unix-​style·​line·​endings.​·​This·​is·​a·​valuable·​tool·​to·​import·​reference·​databases·​from·​Windows·​reference·​managers.​</​p></​dd><dt><span·​class="term">4 »       ​</​span></​dt><dd><p>A·​simple·​(maybe·​<span·​class="emphasis"><em>​too</​em></​span>·​simple)​·​shell·​script·​to·​convert·​text·​files·​like·​RIS·​documents·​from·​DOS-​style·​line·​endings·​to·​Unix-​style·​line·​endings.​·​Most·​RefDB·​tools·​need·​their·​input·​files·​with·​Unix-​style·​line·​endings.​·​This·​is·​a·​valuable·​tool·​to·​import·​reference·​databases·​from·​Windows·​reference·​managers.​</​p></​dd><dt><span·​class="term">
5 »       ​··​<a·​class="link"·​href="re16.​html"·​title="med2ris">med2r​is</​a>5 »       ​··​<a·​class="link"·​href="re16.​html"·​title="med2ris">med2r​is</​a>
6 »       ​</​span></​dt><dd><p>A·​tool·​to·​convert·​Pubmed·​data·​in·​both·​the·​tagged·​and·​the·​XML·​format·​to·​RIS</​p></​dd><dt><span·​class="term">6 »       ​</​span></​dt><dd><p>A·​tool·​to·​convert·​Pubmed·​data·​in·​both·​the·​tagged·​and·​the·​XML·​format·​to·​RIS</​p></​dd><dt><span·​class="term">
7 »       ​··​<a·​class="link"·​href="re14.​html"·​title="en2ris">en2ris​</​a>7 »       ​··​<a·​class="link"·​href="re14.​html"·​title="en2ris">en2ris​</​a>
8 »       ​</​span></​dt><dd><p>A·​tool·​to·​convert·​EndNote·​"RIS"·​exported·​data·​to·​RIS</​p></​dd><dt><span·​class="term">8 »       ​</​span></​dt><dd><p>A·​tool·​to·​convert·​EndNote·​"RIS"·​exported·​data·​to·​RIS</​p></​dd><dt><span·​class="term">
9 »       ​··​<a·​class="link"·​href="re12.​html"·​title="bib2ris">bib2r​is</​a>9 »       ​··​<a·​class="link"·​href="re12.​html"·​title="bib2ris">bib2r​is</​a>
/usr/local/share/doc/refdb/ch08.html
Offset 1, 17 lines modifiedOffset 1, 17 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 8.​ Reference·​management</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​><link·​rel="prev"·​href="ch07s06.​html"·​title="Input·​data·​mangling"·​/​><link·​rel="next"·​href="ch08s02.​html"·​title="Find·​and·​view·​references"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 8.​ Reference·​management</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch07s06.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​II.​ User·​manual</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​h·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 8.​ Reference·​management</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​><link·​rel="prev"·​href="ch07s06.​html"·​title="Input·​data·​mangling"·​/​><link·​rel="next"·​href="ch08s02.​html"·​title="Find·​and·​view·​references"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 8.​ Reference·​management</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch07s06.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​II.​ User·​manual</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​h·​✂
3 »       ​······​<code·​class="prompt">~#·​</​code>3 »       ​······​<code·​class="prompt">~#·​</​code>
4 »       ​······​<strong·​class="userinput"><co​de>med2ris.​pl·​-​o·​foo.​ris·​pm*</​code></​strong>4 »       ​······​<strong·​class="userinput"><co​de>med2ris.​pl·​-​o·​foo.​ris·​pm*</​code></​strong>
5 »       ​····​</​pre><p>We·​could·​now·​open·​<code·​class="filename">foo.​ris</​code>·​in·​our·​favourite·​text·​editor·​and·​make·​a·​few·​changes.​·​We·​could·​enter·​additional·​keywords,​·​provide·​personal·​notes·​(e.​g.​·​why·​we·​currently·​find·​the·​article·​worth·​the·​paper·​it·​is·​printed·​on,​·​something·​that·​may·​not·​be·​apparent·​a·​few·​months·​later)​,​·​or·​specify·​the·​reprint·​status·​and·​availability.​</​p></​li><li·​class="listitem"><p>T​hen·​we·​switch·​to·​(or·​start)​·​the·​refdbc·​command·​line·​client·​and·​type·​the·​following·​command·​at·​the·​prompt·​to·​add·​the·​references·​to·​the·​database·​<code·​class="filename">bar<​/​code>·​(use·​the·​full·​path·​to·​<code·​class="filename">foo.​ris</​code>·​if·​necessary)​:​</​p><pre·​class="screen">5 »       ​····​</​pre><p>We·​could·​now·​open·​<code·​class="filename">foo.​ris</​code>·​in·​our·​favourite·​text·​editor·​and·​make·​a·​few·​changes.​·​We·​could·​enter·​additional·​keywords,​·​provide·​personal·​notes·​(e.​g.​·​why·​we·​currently·​find·​the·​article·​worth·​the·​paper·​it·​is·​printed·​on,​·​something·​that·​may·​not·​be·​apparent·​a·​few·​months·​later)​,​·​or·​specify·​the·​reprint·​status·​and·​availability.​</​p></​li><li·​class="listitem"><p>T​hen·​we·​switch·​to·​(or·​start)​·​the·​refdbc·​command·​line·​client·​and·​type·​the·​following·​command·​at·​the·​prompt·​to·​add·​the·​references·​to·​the·​database·​<code·​class="filename">bar<​/​code>·​(use·​the·​full·​path·​to·​<code·​class="filename">foo.​ris</​code>·​if·​necessary)​:​</​p><pre·​class="screen">
6 »       ​······​<code·​class="prompt">refdbc​:​·​</​code>6 »       ​······​<code·​class="prompt">refdbc​:​·​</​code>
7 »       ​······​<strong·​class="userinput"><co​de>addref·​-​d·​bar·​foo.​ris</​code></​strong>7 »       ​······​<strong·​class="userinput"><co​de>addref·​-​d·​bar·​foo.​ris</​code></​strong>
8 »       ​····​</​pre></​li></​ul></​div></​div><div·​class="simplesect"·​title="Example·​2"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59113912"></​a>Example·​2</​h4></​div></​div></​div><p>You·​feel·​the·​urge·​to·​import·​MODS·​data,​·​an·​XML·​data·​format·​developed·​by·​the·​<a·​class="ulink"·​href="http:​/​/​www.​loc.​gov"·​target="_top">Library​·​of·​Congress</​a>.​·​RefDB·​does·​not·​support·​this·​format·​natively·​or·​via·​converters·​at·​this·​time,​·​so·​you'll·​have·​to·​resort·​to·​an·​external·​tool.​·​Chris·​Putnam's·​<a·​class="ulink"·​href="http:​/​/​www.​scripps.​edu/​~cdputnam/​software/​bibutils/​bibutils.​html"·​target="_top">bibutil​s</​a>·​package·​comes·​to·​the·​rescue,​·​as·​it·​provides·​a·​set·​of·​command-​line·​tools·​to·​interconvert·​a·​number·​of·​bibliography·​data·​formats.​·​Both·​RIS·​and·​MODS·​are·​supported,​·​so·​we·​have·​all·​it·​takes.​·​The·​following·​command·​imports·​the·​MODS·​data·​into·​your·​default·​database·​in·​a·​single·​step,​·​although·​you·​may·​first·​want·​to·​check·​the·​output·​of·​the·​converter·​before·​going·​ahead:​</​p><pre·​class="screen">8 »       ​····​</​pre></​li></​ul></​div></​div><div·​class="simplesect"·​title="Example·​2"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp59163064"></​a>Example·​2</​h4></​div></​div></​div><p>You·​feel·​the·​urge·​to·​import·​MODS·​data,​·​an·​XML·​data·​format·​developed·​by·​the·​<a·​class="ulink"·​href="http:​/​/​www.​loc.​gov"·​target="_top">Library​·​of·​Congress</​a>.​·​RefDB·​does·​not·​support·​this·​format·​natively·​or·​via·​converters·​at·​this·​time,​·​so·​you'll·​have·​to·​resort·​to·​an·​external·​tool.​·​Chris·​Putnam's·​<a·​class="ulink"·​href="http:​/​/​www.​scripps.​edu/​~cdputnam/​software/​bibutils/​bibutils.​html"·​target="_top">bibutil​s</​a>·​package·​comes·​to·​the·​rescue,​·​as·​it·​provides·​a·​set·​of·​command-​line·​tools·​to·​interconvert·​a·​number·​of·​bibliography·​data·​formats.​·​Both·​RIS·​and·​MODS·​are·​supported,​·​so·​we·​have·​all·​it·​takes.​·​The·​following·​command·​imports·​the·​MODS·​data·​into·​your·​default·​database·​in·​a·​single·​step,​·​although·​you·​may·​first·​want·​to·​check·​the·​output·​of·​the·​converter·​before·​going·​ahead:​</​p><pre·​class="screen">
9 »       ​······​<code·​class="prompt">#·​</​code><strong·​class="userinput"><co​de>xml2ris·​modsdata.​xml|refdbc·​-​C·​addref</​code></​strong>9 »       ​······​<code·​class="prompt">#·​</​code><strong·​class="userinput"><co​de>xml2ris·​modsdata.​xml|refdbc·​-​C·​addref</​code></​strong>
10 »       ​····​</​pre></​div></​div><div·​class="sect2"·​title="risx·​datasets"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​id="sect-​add-​risx-​datasets"></​a>risx·​datasets</​h3></​div></​div></​div><p>If·​you·​prefer·​the·​XML·​data·​format·​instead,​·​use·​the·​<a·​class="link"·​href="re11.​html#app-​c-​command-​addref"·​title="addref"><span·​class="command"><stro​ng>addref</​strong></​span></​a>·​with·​the·​<code·​class="option">-​A·​risx</​code>·​switch.​·​As·​the·​data·​are·​imported·​using·​a·​non-​validating·​XML·​parser·​you·​should·​make·​sure·​the·​documents·​are·​valid,​·​either·​by·​using·​some·​nifty·​feature·​of·​your·​XML·​editor·​or·​by·​running·​the·​document·​through·​a·​suitable·​tool·​like·​<span·​class="command"><stro​ng>xmllint</​strong></​span>.​</​p><p>Each·​entry·​in·​a·​risx·​document·​can·​specify·​a·​numerical·​ID·​value·​and·​an·​alphanumeric·​citation·​key.​·​The·​ID·​is·​ignored·​by·​the·​import·​routines.​·​If·​you·​want·​to·​update·​or·​replace·​an·​entry·​by·​ID,​·​you·​have·​to·​use·​the·​<a·​class="link"·​href="re11.​html#app-​c-​command-​updateref"·​title="updateref"><sp​an·​class="command"><stro​ng>updateref</​stron·​✂10 »       ​····​</​pre></​div></​div><div·​class="sect2"·​title="risx·​datasets"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​id="sect-​add-​risx-​datasets"></​a>risx·​datasets</​h3></​div></​div></​div><p>If·​you·​prefer·​the·​XML·​data·​format·​instead,​·​use·​the·​<a·​class="link"·​href="re11.​html#app-​c-​command-​addref"·​title="addref"><span·​class="command"><stro​ng>addref</​strong></​span></​a>·​with·​the·​<code·​class="option">-​A·​risx</​code>·​switch.​·​As·​the·​data·​are·​imported·​using·​a·​non-​validating·​XML·​parser·​you·​should·​make·​sure·​the·​documents·​are·​valid,​·​either·​by·​using·​some·​nifty·​feature·​of·​your·​XML·​editor·​or·​by·​running·​the·​document·​through·​a·​suitable·​tool·​like·​<span·​class="command"><stro​ng>xmllint</​strong></​span>.​</​p><p>Each·​entry·​in·​a·​risx·​document·​can·​specify·​a·​numerical·​ID·​value·​and·​an·​alphanumeric·​citation·​key.​·​The·​ID·​is·​ignored·​by·​the·​import·​routines.​·​If·​you·​want·​to·​update·​or·​replace·​an·​entry·​by·​ID,​·​you·​have·​to·​use·​the·​<a·​class="link"·​href="re11.​html#app-​c-​command-​updateref"·​title="updateref"><sp​an·​class="command"><stro​ng>updateref</​stron·​✂
11 »       ​······​<code·​class="prompt">~#·​</​code>11 »       ​······​<code·​class="prompt">~#·​</​code>
12 »       ​······​<strong·​class="userinput"><co​de>onsgmls·​-​s·​/​usr/​local/​share/​refdb/​declarations/​xml.​dcl·​foo.​xml</​code></​strong>12 »       ​······​<strong·​class="userinput"><co​de>onsgmls·​-​s·​/​usr/​local/​share/​refdb/​declarations/​xml.​dcl·​foo.​xml</​code></​strong>
13 »       ​······​<code·​class="prompt">~#·​</​code>13 »       ​······​<code·​class="prompt">~#·​</​code>
14 »       ​······​<strong·​class="userinput"><co​de>xmllint·​-​-​noout·​-​-​dtdvalid·​"http:​/​/​refdb.​sourceforge.​net/​dtd/​risx/​risx.​dtd"·​foo.​xml</​code></​strong>14 »       ​······​<strong·​class="userinput"><co​de>xmllint·​-​-​noout·​-​-​dtdvalid·​"http:​/​/​refdb.​sourceforge.​net/​dtd/​risx/​risx.​dtd"·​foo.​xml</​code></​strong>
15 »       ​····​</​pre><p>No·​news·​is·​good·​news·​in·​both·​cases:​·​If·​your·​document·​is·​valid,​·​the·​validator·​will·​not·​output·​anything.​·​If·​you·​do·​get·​some·​error·​messages,​·​go·​back·​to·​your·​editor·​and·​fix·​the·​problems.​</​p></​li><li·​class="listitem"><p>N​ow·​switch·​to·​refdbc·​and·​run·​the·​following·​command·​to·​add·​the·​references·​in·​<code·​class="filename">foo.​xml</​code>·​to·​the·​reference·​database·​<code·​class="filename">bar<​/​code>:​</​p><pre·​class="screen">15 »       ​····​</​pre><p>No·​news·​is·​good·​news·​in·​both·​cases:​·​If·​your·​document·​is·​valid,​·​the·​validator·​will·​not·​output·​anything.​·​If·​you·​do·​get·​some·​error·​messages,​·​go·​back·​to·​your·​editor·​and·​fix·​the·​problems.​</​p></​li><li·​class="listitem"><p>N​ow·​switch·​to·​refdbc·​and·​run·​the·​following·​command·​to·​add·​the·​references·​in·​<code·​class="filename">foo.​xml</​code>·​to·​the·​reference·​database·​<code·​class="filename">bar<​/​code>:​</​p><pre·​class="screen">
16 »       ​······​<code·​class="prompt">refdbc​:​·​</​code>16 »       ​······​<code·​class="prompt">refdbc​:​·​</​code>
17 »       ​······​<strong·​class="userinput"><co​de>addref·​-​A·​risx·​-​d·​bar·​foo.​xml</​code></​strong>17 »       ​······​<strong·​class="userinput"><co​de>addref·​-​A·​risx·​-​d·​bar·​foo.​xml</​code></​strong>
/usr/local/share/doc/refdb/ch08s02.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Find·​and·​view·​references</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch08.​html"·​title="Chapter 8.​ Reference·​management"·​/​><link·​rel="prev"·​href="ch08.​html"·​title="Chapter 8.​ Reference·​management"·​/​><link·​rel="next"·​href="ch08s03.​html"·​title="Delete·​references"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Find·​and·​view·​references</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch08.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 8.​ Reference·​management</​th><td·​width="20%"·​align="right"> <a·​accesskey=·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Find·​and·​view·​references</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch08.​html"·​title="Chapter 8.​ Reference·​management"·​/​><link·​rel="prev"·​href="ch08.​html"·​title="Chapter 8.​ Reference·​management"·​/​><link·​rel="next"·​href="ch08s03.​html"·​title="Delete·​references"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Find·​and·​view·​references</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch08.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 8.​ Reference·​management</​th><td·​width="20%"·​align="right"> <a·​accesskey=·​✂
/usr/local/share/doc/refdb/ch08s03.html
Offset 1, 8 lines modifiedOffset 1, 8 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Delete·​references</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch08.​html"·​title="Chapter 8.​ Reference·​management"·​/​><link·​rel="prev"·​href="ch08s02.​html"·​title="Find·​and·​view·​references"·​/​><link·​rel="next"·​href="ch08s04.​html"·​title="Edit·​references"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Delete​·​references</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch08s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 8.​ Reference·​management</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href="ch08s04·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Delete·​references</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch08.​html"·​title="Chapter 8.​ Reference·​management"·​/​><link·​rel="prev"·​href="ch08s02.​html"·​title="Find·​and·​view·​references"·​/​><link·​rel="next"·​href="ch08s04.​html"·​title="Edit·​references"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Delete​·​references</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch08s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 8.​ Reference·​management</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href="ch08s04·​✂
3 »       ​····​<code·​class="prompt">refdbc​:​·​</​code>3 »       ​····​<code·​class="prompt">refdbc​:​·​</​code>
4 »       ​····​<strong·​class="userinput"><co​de>getref·​-​t·​ris·​-​s·​ID·​-​o·​tobekilled.​ris·​-​d·​bar·​":​AU:​=Doe,​J.​"</​code></​strong>4 »       ​····​<strong·​class="userinput"><co​de>getref·​-​t·​ris·​-​s·​ID·​-​o·​tobekilled.​ris·​-​d·​bar·​":​AU:​=Doe,​J.​"</​code></​strong>
5 »       ​··​</​pre><p>The·​result·​is,​·​once·​again,​·​a·​file·​with·​plain·​text·​that·​we·​can·​check·​and·​edit·​to·​our·​needs.​·​E.​g.​·​if·​you·​want·​to·​keep·​one·​or·​two·​publications·​in·​the·​list,​·​just·​delete·​their·​entries·​in·​the·​intermediate·​file.​</​p></​li><li·​class="listitem"><p>T​hen·​we·​use·​the·​<a·​class="link"·​href="re11.​html#app-​c-​command-​deleteref"·​title="deleteref">del​eteref</​a>·​command·​to·​actually·​delete·​the·​references·​associated·​with·​our·​list·​of·​IDs:​</​p><pre·​class="screen"·​width="60">5 »       ​··​</​pre><p>The·​result·​is,​·​once·​again,​·​a·​file·​with·​plain·​text·​that·​we·​can·​check·​and·​edit·​to·​our·​needs.​·​E.​g.​·​if·​you·​want·​to·​keep·​one·​or·​two·​publications·​in·​the·​list,​·​just·​delete·​their·​entries·​in·​the·​intermediate·​file.​</​p></​li><li·​class="listitem"><p>T​hen·​we·​use·​the·​<a·​class="link"·​href="re11.​html#app-​c-​command-​deleteref"·​title="deleteref">del​eteref</​a>·​command·​to·​actually·​delete·​the·​references·​associated·​with·​our·​list·​of·​IDs:​</​p><pre·​class="screen"·​width="60">
6 »       ​····​<code·​class="prompt">refdbc​:​·​</​code>6 »       ​····​<code·​class="prompt">refdbc​:​·​</​code>
7 »       ​····​<strong·​class="userinput"><co​de>deleteref·​-​f·​tobekilled.​ris·​-​d·​bar</​code></​strong>7 »       ​····​<strong·​class="userinput"><co​de>deleteref·​-​f·​tobekilled.​ris·​-​d·​bar</​code></​strong>
8 »       ​··​</​pre></​li></​ul></​div></​div></​div><div·​class="navfooter"><hr​·​/​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ch08s02.​html">Prev</​a> </​td><td·​width="20%"·​align="center"><a·​accesskey="u"·​href="ch08.​html">Up</​a></​td><td·​width="40%"·​align="right"> <a·​accesskey="n"·​href="ch08s04.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Find·​and·​view·​references </​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top"> Edit·​references</​td></​tr></​table></​div></​body></​html>8 »       ​··​</​pre></​li></​ul></​div></​div></​div><div·​class="navfooter"><hr​·​/​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ch08s02.​html">Prev</​a> </​td><td·​width="20%"·​align="center"><a·​accesskey="u"·​href="ch08.​html">Up</​a></​td><td·​width="40%"·​align="right"> <a·​accesskey="n"·​href="ch08s04.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Find·​and·​view·​references </​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top"> Edit·​references</​td></​tr></​table></​div></​body></​html>
/usr/local/share/doc/refdb/ch08s08.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Create·​periodical·​synonyms</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch08.​html"·​title="Chapter 8.​ Reference·​management"·​/​><link·​rel="prev"·​href="ch08s07.​html"·​title="Global·​edit·​references"·​/​><link·​rel="next"·​href="ch08s09.​html"·​title="Character·​encoding·​issues"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Create​·​periodical·​synonyms</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch08s07.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 8.​ Reference·​management</​th><td·​width="20%"·​align="right"> <a·​a·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Create·​periodical·​synonyms</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch08.​html"·​title="Chapter 8.​ Reference·​management"·​/​><link·​rel="prev"·​href="ch08s07.​html"·​title="Global·​edit·​references"·​/​><link·​rel="next"·​href="ch08s09.​html"·​title="Character·​encoding·​issues"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Create​·​periodical·​synonyms</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch08s07.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 8.​ Reference·​management</​th><td·​width="20%"·​align="right"> <a·​a·​✂
/usr/local/share/doc/refdb/ch08s09.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Character·​encoding·​issues</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch08.​html"·​title="Chapter 8.​ Reference·​management"·​/​><link·​rel="prev"·​href="ch08s08.​html"·​title="Create·​periodical·​synonyms"·​/​><link·​rel="next"·​href="ch08s10.​html"·​title="Use·​pdfroot"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Charac​ter·​encoding·​issues</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch08s08.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 8.​ Reference·​management</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Character·​encoding·​issues</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch08.​html"·​title="Chapter 8.​ Reference·​management"·​/​><link·​rel="prev"·​href="ch08s08.​html"·​title="Create·​periodical·​synonyms"·​/​><link·​rel="next"·​href="ch08s10.​html"·​title="Use·​pdfroot"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Charac​ter·​encoding·​issues</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch08s08.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 8.​ Reference·​management</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​✂
/usr/local/share/doc/refdb/ch09.html
Offset 1, 5 lines modifiedOffset 1, 5 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 9.​ Notes·​management</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​><link·​rel="prev"·​href="ch08s11.​html"·​title="Interaction·​with·​external·​applications"·​/​><link·​rel="next"·​href="ch09s02.​html"·​title="Find·​and·​view·​extended·​notes"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 9.​ Notes·​management</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch08s11.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​II.​ User·​manual</​th><td·​width="20%"·​align="right"> <a··​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 9.​ Notes·​management</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt03.​html"·​title="Part III.​ User·​manual"·​/​><link·​rel="prev"·​href="ch08s11.​html"·​title="Interaction·​with·​external·​applications"·​/​><link·​rel="next"·​href="ch09s02.​html"·​title="Find·​and·​view·​extended·​notes"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 9.​ Notes·​management</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch08s11.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​II.​ User·​manual</​th><td·​width="20%"·​align="right"> <a··​✂
3 »       ​<code·​class="prompt">refdbc​:​·​</​code>3 »       ​<code·​class="prompt">refdbc​:​·​</​code>
4 »       ​<strong·​class="userinput"><co​de>addnote·​-​d·​bar·​foo.​xml</​code></​strong>4 »       ​<strong·​class="userinput"><co​de>addnote·​-​d·​bar·​foo.​xml</​code></​strong>
5 ······​</​pre></​div></​div></​div><div·​class="navfooter"><hr​·​/​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ch08s11.​html">Prev</​a> </​td><td·​width="20%"·​align="center"><a·​accesskey="u"·​href="pt03.​html">Up</​a></​td><td·​width="40%"·​align="right"> <a·​accesskey="n"·​href="ch09s02.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Interact​ion·​with·​external·​applications </​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top"> Find·​and·​view·​extended·​notes</​td></​tr></​table></​div></​body></​html>5 ······​</​pre></​div></​div></​div><div·​class="navfooter"><hr​·​/​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ch08s11.​html">Prev</​a> </​td><td·​width="20%"·​align="center"><a·​accesskey="u"·​href="pt03.​html">Up</​a></​td><td·​width="40%"·​align="right"> <a·​accesskey="n"·​href="ch09s02.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Interact​ion·​with·​external·​applications </​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top"> Find·​and·​view·​extended·​notes</​td></​tr></​table></​div></​body></​html>
/usr/local/share/doc/refdb/ch09s03.html
Offset 1, 5 lines modifiedOffset 1, 5 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Delete·​extended·​notes</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch09.​html"·​title="Chapter 9.​ Notes·​management"·​/​><link·​rel="prev"·​href="ch09s02.​html"·​title="Find·​and·​view·​extended·​notes"·​/​><link·​rel="next"·​href="ch09s04.​html"·​title="Edit·​extended·​notes"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Delete​·​extended·​notes</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch09s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 9.​ Notes·​management</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href=·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Delete·​extended·​notes</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch09.​html"·​title="Chapter 9.​ Notes·​management"·​/​><link·​rel="prev"·​href="ch09s02.​html"·​title="Find·​and·​view·​extended·​notes"·​/​><link·​rel="next"·​href="ch09s04.​html"·​title="Edit·​extended·​notes"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Delete​·​extended·​notes</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch09s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 9.​ Notes·​management</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href=·​✂
3 »       ​<code·​class="prompt">refdbc​:​·​</​code>3 »       ​<code·​class="prompt">refdbc​:​·​</​code>
4 »       ​<strong·​class="userinput"><co​de>deletenote·​-​d·​bar·​4·​132</​code></​strong>4 »       ​<strong·​class="userinput"><co​de>deletenote·​-​d·​bar·​4·​132</​code></​strong>
5 ······​</​pre></​div></​div><div·​class="navfooter"><hr​·​/​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ch09s02.​html">Prev</​a> </​td><td·​width="20%"·​align="center"><a·​accesskey="u"·​href="ch09.​html">Up</​a></​td><td·​width="40%"·​align="right"> <a·​accesskey="n"·​href="ch09s04.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Find·​and·​view·​extended·​notes </​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top"> Edit·​extended·​notes</​td></​tr></​table></​div></​body></​html>5 ······​</​pre></​div></​div><div·​class="navfooter"><hr​·​/​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ch09s02.​html">Prev</​a> </​td><td·​width="20%"·​align="center"><a·​accesskey="u"·​href="ch09.​html">Up</​a></​td><td·​width="40%"·​align="right"> <a·​accesskey="n"·​href="ch09s04.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Find·​and·​view·​extended·​notes </​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top"> Edit·​extended·​notes</​td></​tr></​table></​div></​body></​html>
/usr/local/share/doc/refdb/ch09s05.html
Offset 1, 5 lines modifiedOffset 1, 5 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Link·​existing·​notes·​to·​other·​objects·​in·​the·​database</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch09.​html"·​title="Chapter 9.​ Notes·​management"·​/​><link·​rel="prev"·​href="ch09s04.​html"·​title="Edit·​extended·​notes"·​/​><link·​rel="next"·​href="ch09s06.​html"·​title="To·​share·​or·​not·​to·​share·​extended·​notes"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Link·​existing·​notes·​to·​other·​objects·​in·​the·​database</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch09s04.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 9.​ N·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Link·​existing·​notes·​to·​other·​objects·​in·​the·​database</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch09.​html"·​title="Chapter 9.​ Notes·​management"·​/​><link·​rel="prev"·​href="ch09s04.​html"·​title="Edit·​extended·​notes"·​/​><link·​rel="next"·​href="ch09s06.​html"·​title="To·​share·​or·​not·​to·​share·​extended·​notes"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Link·​existing·​notes·​to·​other·​objects·​in·​the·​database</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch09s04.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 9.​ N·​✂
3 »       ​<code·​class="prompt">refdbc​:​·​</​code>3 »       ​<code·​class="prompt">refdbc​:​·​</​code>
4 »       ​<strong·​class="userinput"><co​de>addlink·​-​d·​bar·​:​NID:​=5·​:​CK:​=Miller1999·​:​CK:​=Doe2000</​code></​strong>4 »       ​<strong·​class="userinput"><co​de>addlink·​-​d·​bar·​:​NID:​=5·​:​CK:​=Miller1999·​:​CK:​=Doe2000</​code></​strong>
5 ······​</​pre></​div></​div><div·​class="navfooter"><hr​·​/​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ch09s04.​html">Prev</​a> </​td><td·​width="20%"·​align="center"><a·​accesskey="u"·​href="ch09.​html">Up</​a></​td><td·​width="40%"·​align="right"> <a·​accesskey="n"·​href="ch09s06.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Edit·​extended·​notes </​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top"> To·​share·​or·​not·​to·​share·​extended·​notes</​td></​tr></​table></​div></​body></​html>5 ······​</​pre></​div></​div><div·​class="navfooter"><hr​·​/​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ch09s04.​html">Prev</​a> </​td><td·​width="20%"·​align="center"><a·​accesskey="u"·​href="ch09.​html">Up</​a></​td><td·​width="40%"·​align="right"> <a·​accesskey="n"·​href="ch09s06.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Edit·​extended·​notes </​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top"> To·​share·​or·​not·​to·​share·​extended·​notes</​td></​tr></​table></​div></​body></​html>
/usr/local/share/doc/refdb/ch09s06.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>To·​share·​or·​not·​to·​share·​extended·​notes</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch09.​html"·​title="Chapter 9.​ Notes·​management"·​/​><link·​rel="prev"·​href="ch09s05.​html"·​title="Link·​existing·​notes·​to·​other·​objects·​in·​the·​database"·​/​><link·​rel="next"·​href="ch10.​html"·​title="Chapter 10.​ Bibliographies"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">To·​share·​or·​not·​to·​share·​extended·​notes</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch09s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 9.​ Notes·​mana·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>To·​share·​or·​not·​to·​share·​extended·​notes</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch09.​html"·​title="Chapter 9.​ Notes·​management"·​/​><link·​rel="prev"·​href="ch09s05.​html"·​title="Link·​existing·​notes·​to·​other·​objects·​in·​the·​database"·​/​><link·​rel="next"·​href="ch10.​html"·​title="Chapter 10.​ Bibliographies"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">To·​share·​or·​not·​to·​share·​extended·​notes</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch09s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 9.​ Notes·​mana·​✂
/usr/local/share/doc/refdb/ch10s03.html
Offset 47, 24 lines modifiedOffset 47, 24 lines modified
47 »       ​··​</​pre><div·​class="calloutlist"><​table·​border="0"·​summary="Callout·​list"><tr><td·​width="5%"·​valign="top"·​align="left"><p><a·​href="#list3-​multixref"><img·​src="images/​callouts/​1.​png"·​alt="1"·​border="0"·​/​></​a>·​</​p></​td><td·​valign="top"·​align="left"><p>This·​is·​the·​additional·​<code·​class="sgmltag-​element">xref</​code>·​element·​which·​is·​mandatory·​in·​multiple·​citations.​·​The·​<code·​class="sgmltag-​attribute">linkend</​code>·​specifies·​the·​target·​of·​a·​link,​·​which·​by·​convention·​could·​be·​the·​first·​of·​the·​following·​references.​·​Note·​that·​the·​attribute·​value·​does·​not·​have·​a·​trailing·​type·​specifier.​·​The·​element·​must·​have·​a·​<code·​class="sgmltag-​attribute">role</​code>·​attribute·​with·​the·​value·​<code·​class="sgmltag-​attvalue">MULTIXREF</​code>.​·​You·​also·​have·​to·​provide·​an·​unique·​value·​for·​the·​<code·​class="sgmltag-​attribute">endterm</​code>·​attribute.​·​This·​specifies·​the·​ID·​value·​that·​will·​be·​used·​in·​the·​corresponding·​element·​in·​the·​RefDB-​generated·​bibliography·​that·​contains·​the·​preformatted·​string·​for·​the·​multiple·​citation.​·​The·​ID·​valu·​✂47 »       ​··​</​pre><div·​class="calloutlist"><​table·​border="0"·​summary="Callout·​list"><tr><td·​width="5%"·​valign="top"·​align="left"><p><a·​href="#list3-​multixref"><img·​src="images/​callouts/​1.​png"·​alt="1"·​border="0"·​/​></​a>·​</​p></​td><td·​valign="top"·​align="left"><p>This·​is·​the·​additional·​<code·​class="sgmltag-​element">xref</​code>·​element·​which·​is·​mandatory·​in·​multiple·​citations.​·​The·​<code·​class="sgmltag-​attribute">linkend</​code>·​specifies·​the·​target·​of·​a·​link,​·​which·​by·​convention·​could·​be·​the·​first·​of·​the·​following·​references.​·​Note·​that·​the·​attribute·​value·​does·​not·​have·​a·​trailing·​type·​specifier.​·​The·​element·​must·​have·​a·​<code·​class="sgmltag-​attribute">role</​code>·​attribute·​with·​the·​value·​<code·​class="sgmltag-​attvalue">MULTIXREF</​code>.​·​You·​also·​have·​to·​provide·​an·​unique·​value·​for·​the·​<code·​class="sgmltag-​attribute">endterm</​code>·​attribute.​·​This·​specifies·​the·​ID·​value·​that·​will·​be·​used·​in·​the·​corresponding·​element·​in·​the·​RefDB-​generated·​bibliography·​that·​contains·​the·​preformatted·​string·​for·​the·​multiple·​citation.​·​The·​ID·​valu·​✂
48 &lt;​ptr·​type="MULTIXREF"·​targOrder="U"·​target="IMTHEFIRST"·​TEIform="ptr"/​&gt;​<a·​id="list4-​multixref"></​a><img·​src="images/​callouts/​1.​png"·​alt="1"·​border="0"·​/​>48 &lt;​ptr·​type="MULTIXREF"·​targOrder="U"·​target="IMTHEFIRST"·​TEIform="ptr"/​&gt;​<a·​id="list4-​multixref"></​a><img·​src="images/​callouts/​1.​png"·​alt="1"·​border="0"·​/​>
49 &lt;​ptr·​targOrder="U"·​target="ID1-​X"·​TEIform="ptr"/​&gt;​·····················​<a·​id="list4-​xref"></​a><img·​src="images/​callouts/​2.​png"·​alt="2"·​border="0"·​/​>49 &lt;​ptr·​targOrder="U"·​target="ID1-​X"·​TEIform="ptr"/​&gt;​·····················​<a·​id="list4-​xref"></​a><img·​src="images/​callouts/​2.​png"·​alt="2"·​border="0"·​/​>
50 &lt;​ptr·​targOrder="U"·​target="LITIBP-​ID21-​X"·​TEIform="ptr"/​&gt;​50 &lt;​ptr·​targOrder="U"·​target="LITIBP-​ID21-​X"·​TEIform="ptr"/​&gt;​
51 &lt;​ptr·​targOrder="U"·​target="ID5-​X"·​TEIform="ptr"/​&gt;​51 &lt;​ptr·​targOrder="U"·​target="ID5-​X"·​TEIform="ptr"/​&gt;​
52 &lt;​/​seg&gt;​52 &lt;​/​seg&gt;​
53 »       ​··​</​pre><div·​class="calloutlist"><​table·​border="0"·​summary="Callout·​list"><tr><td·​width="5%"·​valign="top"·​align="left"><p><a·​href="#list4-​multixref"><img·​src="images/​callouts/​1.​png"·​alt="1"·​border="0"·​/​></​a>·​</​p></​td><td·​valign="top"·​align="left"><p>This·​is·​the·​additional·​<code·​class="sgmltag-​element">ptr</​code>·​element·​which·​is·​mandatory·​in·​multiple·​citations.​·​The·​element·​must·​have·​a·​<code·​class="sgmltag-​attribute">type</​code>·​attribute·​with·​the·​value·​<code·​class="sgmltag-​attvalue">MULTIXREF</​code>.​·​You·​also·​have·​to·​provide·​an·​unique·​value·​for·​the·​<code·​class="sgmltag-​attribute">target</​code>·​attribute.​·​This·​specifies·​the·​ID·​value·​that·​will·​be·​used·​in·​the·​corresponding·​element·​in·​the·​RefDB-​generated·​bibliography.​·​The·​ID·​string·​has·​to·​start·​with·​"IM".​·​In·​contrast·​to·​DocBook·​elements,​·​there·​is·​no·​way·​to·​specify·​where·​a·​link·​should·​point·​to.​·​The·​RefDB·​XSL·​stylesheets·​will·​use·​the·​first·​bibliographic·​entry·​referenced·​in·​a·​multiple·​citation·​as·​the·​link·​target.​</​p></​td></​tr><tr><td·​width="5%"·​valign="top"·​align="·​✂53 »       ​··​</​pre><div·​class="calloutlist"><​table·​border="0"·​summary="Callout·​list"><tr><td·​width="5%"·​valign="top"·​align="left"><p><a·​href="#list4-​multixref"><img·​src="images/​callouts/​1.​png"·​alt="1"·​border="0"·​/​></​a>·​</​p></​td><td·​valign="top"·​align="left"><p>This·​is·​the·​additional·​<code·​class="sgmltag-​element">ptr</​code>·​element·​which·​is·​mandatory·​in·​multiple·​citations.​·​The·​element·​must·​have·​a·​<code·​class="sgmltag-​attribute">type</​code>·​attribute·​with·​the·​value·​<code·​class="sgmltag-​attvalue">MULTIXREF</​code>.​·​You·​also·​have·​to·​provide·​an·​unique·​value·​for·​the·​<code·​class="sgmltag-​attribute">target</​code>·​attribute.​·​This·​specifies·​the·​ID·​value·​that·​will·​be·​used·​in·​the·​corresponding·​element·​in·​the·​RefDB-​generated·​bibliography.​·​The·​ID·​string·​has·​to·​start·​with·​"IM".​·​In·​contrast·​to·​DocBook·​elements,​·​there·​is·​no·​way·​to·​specify·​where·​a·​link·​should·​point·​to.​·​The·​RefDB·​XSL·​stylesheets·​will·​use·​the·​first·​bibliographic·​entry·​referenced·​in·​a·​multiple·​citation·​as·​the·​link·​target.​</​p></​td></​tr><tr><td·​width="5%"·​valign="top"·​align="·​✂
54 </​pre></​div></​div><div·​class="sect3"·​title="Generate·​the·​bibliography"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp60956472"></​a>Generate·​the·​bibliography</​h4></​div></​div></​div><p>Unless·​you·​have·​good·​reasons·​not·​to·​do·​so,​·​you·​should·​use·​the·​<a·​class="link"·​href="re21.​html"·​title="runbib">runbib​</​a>·​shell·​script·​to·​generate·​the·​bibliography.​·​This·​script·​greatly·​simplifies·​this·​task·​and·​offers·​a·​common·​interface·​for·​all·​supported·​document·​types.​·​The·​following·​subsection·​will·​explain·​the·​use·​of·​this·​script.​·​If·​you·​like·​to·​do·​it·​the·​hard·​way·​(or·​if·​you·​want·​to·​peek·​under·​the·​hood)​·​you'll·​find·​a·​few·​explanations·​further·​down·​how·​to·​do·​this.​</​p><div·​class="sect4"·​title="Use·​runbib"><div·​class="titlepage"><di​v><div><h5·​class="title"><a·​id="idp60958008"></​a>Use·​runbib</​h5></​div></​div></​div><p>Lets·​assume·​you·​have·​a·​DocBook·​SGML·​document·​<code·​class="filename">mypa​per.​sgml</​code>·​and·​want·​to·​submit·​it·​to·​the·​"Journal·​of·​Irreproducible·​Results".​·​We·​further·​assume·​that·​the·​bibliography·​style·​for·​this·​f·​✂54 </​pre></​div></​div><div·​class="sect3"·​title="Generate·​the·​bibliography"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​id="idp60948280"></​a>Generate·​the·​bibliography</​h4></​div></​div></​div><p>Unless·​you·​have·​good·​reasons·​not·​to·​do·​so,​·​you·​should·​use·​the·​<a·​class="link"·​href="re21.​html"·​title="runbib">runbib​</​a>·​shell·​script·​to·​generate·​the·​bibliography.​·​This·​script·​greatly·​simplifies·​this·​task·​and·​offers·​a·​common·​interface·​for·​all·​supported·​document·​types.​·​The·​following·​subsection·​will·​explain·​the·​use·​of·​this·​script.​·​If·​you·​like·​to·​do·​it·​the·​hard·​way·​(or·​if·​you·​want·​to·​peek·​under·​the·​hood)​·​you'll·​find·​a·​few·​explanations·​further·​down·​how·​to·​do·​this.​</​p><div·​class="sect4"·​title="Use·​runbib"><div·​class="titlepage"><di​v><div><h5·​class="title"><a·​id="idp60949816"></​a>Use·​runbib</​h5></​div></​div></​div><p>Lets·​assume·​you·​have·​a·​DocBook·​SGML·​document·​<code·​class="filename">mypa​per.​sgml</​code>·​and·​want·​to·​submit·​it·​to·​the·​"Journal·​of·​Irreproducible·​Results".​·​We·​further·​assume·​that·​the·​bibliography·​style·​for·​this·​f·​✂
55 »       ​····​<code·​class="prompt">~$·​</​code>55 »       ​····​<code·​class="prompt">~$·​</​code>
56 »       ​····​<strong·​class="userinput"><co​de>runbib·​-​d·​mybib·​-​S·​"J.​Irrep.​Res.​"·​-​t·​db31·​foo.​sgml</​code></​strong>56 »       ​····​<strong·​class="userinput"><co​de>runbib·​-​d·​mybib·​-​S·​"J.​Irrep.​Res.​"·​-​t·​db31·​foo.​sgml</​code></​strong>
57 »       ​··​</​pre><p>For·​a·​similar·​TEI·​XML·​document·​<code·​class="filename">bar.​xml</​code>·​you·​would·​run:​</​p><pre·​class="screen">57 »       ​··​</​pre><p>For·​a·​similar·​TEI·​XML·​document·​<code·​class="filename">bar.​xml</​code>·​you·​would·​run:​</​p><pre·​class="screen">
58 »       ​····​<code·​class="prompt">~$·​</​code>58 »       ​····​<code·​class="prompt">~$·​</​code>
59 »       ​····​<strong·​class="userinput"><co​de>runbib·​-​d·​mybib·​-​S·​"J.​Irrep.​Res.​"·​-​t·​teix·​bar.​xml</​code></​strong>59 »       ​····​<strong·​class="userinput"><co​de>runbib·​-​d·​mybib·​-​S·​"J.​Irrep.​Res.​"·​-​t·​teix·​bar.​xml</​code></​strong>
60 »       ​··​</​pre><p>In·​both·​cases·​you·​will·​end·​up·​with·​a·​bibliography·​file·​(<code·​class="filename">foo.​bib.​sgml</​code>·​and·​<code·​class="filename">bar.​bib.​xml</​code>,​·​respectively)​·​as·​well·​as·​with·​a·​stylesheet·​(<code·​class="filename">J.​Irrep.​Res.​dsl</​code>)​·​or·​a·​set·​of·​stylesheets·​(<code·​class="filename">J.​Irrep.​Res.​fo.​xsl</​code>·​and·​<code·​class="filename">J.​Irrep.​Res.​html.​xsl</​code>)​,​·​respectively.​</​p><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>Don't·​worry·​if·​you·​are·​greeted·​by·​a·​list·​of·​(Open)​Jade·​errors·​complaining·​about·​missing·​elements·​when·​you·​first·​run·​this·​script·​on·​a·​particular·​document.​·​Your·​document·​contains·​a·​number·​of·​crosslinks·​that·​point·​to·​elements·​that·​do·​not·​exist·​yet·​-​·​you·​use·​runbib·​precisely·​to·​create·​these·​elements·​(you·​thus·​face·​a·​classic·​bootstrapping·​problem)​.​·​As·​soon·​as·​the·​bibliography·​is·​created,​·​these·​error·​messages·​should·​go·​away.​·​Later·​you·​will·​only·​get·​an·​error·​message·​for·​each·​bibliographic·​entry·​that·​was·​added·​since·​the·​✂60 »       ​··​</​pre><p>In·​both·​cases·​you·​will·​end·​up·​with·​a·​bibliography·​file·​(<code·​class="filename">foo.​bib.​sgml</​code>·​and·​<code·​class="filename">bar.​bib.​xml</​code>,​·​respectively)​·​as·​well·​as·​with·​a·​stylesheet·​(<code·​class="filename">J.​Irrep.​Res.​dsl</​code>)​·​or·​a·​set·​of·​stylesheets·​(<code·​class="filename">J.​Irrep.​Res.​fo.​xsl</​code>·​and·​<code·​class="filename">J.​Irrep.​Res.​html.​xsl</​code>)​,​·​respectively.​</​p><div·​class="note"·​title="Note"·​style="margin-​left:​·​0.​5in;​·​margin-​right:​·​0.​5in;​"><h3·​class="title">Note</​h3><p>Don't·​worry·​if·​you·​are·​greeted·​by·​a·​list·​of·​(Open)​Jade·​errors·​complaining·​about·​missing·​elements·​when·​you·​first·​run·​this·​script·​on·​a·​particular·​document.​·​Your·​document·​contains·​a·​number·​of·​crosslinks·​that·​point·​to·​elements·​that·​do·​not·​exist·​yet·​-​·​you·​use·​runbib·​precisely·​to·​create·​these·​elements·​(you·​thus·​face·​a·​classic·​bootstrapping·​problem)​.​·​As·​soon·​as·​the·​bibliography·​is·​created,​·​these·​error·​messages·​should·​go·​away.​·​Later·​you·​will·​only·​get·​an·​error·​message·​for·​each·​bibliographic·​entry·​that·​was·​added·​since·​the·​✂
61 »       ​····​<code·​class="prompt">~$·​</​code>61 »       ​····​<code·​class="prompt">~$·​</​code>
62 »       ​····​<strong·​class="userinput"><co​de>runbib·​-​d·​mybib·​-​r·​-​t·​db50x·​bar.​xml</​code></​strong>62 »       ​····​<strong·​class="userinput"><co​de>runbib·​-​d·​mybib·​-​r·​-​t·​db50x·​bar.​xml</​code></​strong>
63 »       ​··​</​pre><p>This·​will·​create·​a·​raw·​bibliography·​from·​the·​DocBook·​5.​0·​document·​<code·​class="filename">bar.​xml</​code>,​·​using·​the·​reference·​entries·​in·​the·​database·​<code·​class="filename">mybi​b</​code>.​</​p></​div><div·​class="sect4"·​title="Do·​it·​the·​hard·​way"><div·​class="titlepage"><di​v><div><h5·​class="title"><a·​id="idp60972856"></​a>Do·​it·​the·​hard·​way</​h5></​div></​div></​div><p>The·​following·​steps·​do·​exactly·​what·​the·​runbib·​script·​does,​·​just·​with·​more·​to·​type.​·​The·​only·​benefit·​of·​the·​hard·​way·​is·​that·​you·​have·​a·​chance·​to·​fiddle·​with·​the·​intermediate·​XML·​file·​which·​contains·​the·​list·​of·​bibliographic·​entries·​that·​should·​go·​into·​the·​bibliography.​·​You·​can·​add·​further·​entries·​to·​extend·​the·​bibliography·​if·​you·​want·​to·​include·​uncited·​publications.​·​The·​following·​procedure·​was·​written·​with·​a·​DocBook·​SGML·​document·​in·​mind,​·​but·​transferring·​the·​commands·​to·​XML·​documents·​is·​straightforward.​·​However,​·​when·​working·​with·​XML·​documents·​there·​are·​additional·​steps·​required·​as·​outlined·​below.​</​p><div·​class="procedure"><ol​·​class="procedu·​✂63 »       ​··​</​pre><p>This·​will·​create·​a·​raw·​bibliography·​from·​the·​DocBook·​5.​0·​document·​<code·​class="filename">bar.​xml</​code>,​·​using·​the·​reference·​entries·​in·​the·​database·​<code·​class="filename">mybi​b</​code>.​</​p></​div><div·​class="sect4"·​title="Do·​it·​the·​hard·​way"><div·​class="titlepage"><di​v><div><h5·​class="title"><a·​id="idp60964664"></​a>Do·​it·​the·​hard·​way</​h5></​div></​div></​div><p>The·​following·​steps·​do·​exactly·​what·​the·​runbib·​script·​does,​·​just·​with·​more·​to·​type.​·​The·​only·​benefit·​of·​the·​hard·​way·​is·​that·​you·​have·​a·​chance·​to·​fiddle·​with·​the·​intermediate·​XML·​file·​which·​contains·​the·​list·​of·​bibliographic·​entries·​that·​should·​go·​into·​the·​bibliography.​·​You·​can·​add·​further·​entries·​to·​extend·​the·​bibliography·​if·​you·​want·​to·​include·​uncited·​publications.​·​The·​following·​procedure·​was·​written·​with·​a·​DocBook·​SGML·​document·​in·​mind,​·​but·​transferring·​the·​commands·​to·​XML·​documents·​is·​straightforward.​·​However,​·​when·​working·​with·​XML·​documents·​there·​are·​additional·​steps·​required·​as·​outlined·​below.​</​p><div·​class="procedure"><ol​·​class="procedu·​✂
64 »       ​»       ​<code·​class="prompt">#~·​</​code>64 »       ​»       ​<code·​class="prompt">#~·​</​code>
65 »       ​»       ​<strong·​class="userinput"><co​de>openjade·​-​t·​sgml·​-​d·​citations.​dsl·​/​usr/​lib/​sgml/​declaration/​docbook-​3.​1.​dcl·​foo.​sgml·​&gt;​·​foo.​id.​xml</​code></​strong>65 »       ​»       ​<strong·​class="userinput"><co​de>openjade·​-​t·​sgml·​-​d·​citations.​dsl·​/​usr/​lib/​sgml/​declaration/​docbook-​3.​1.​dcl·​foo.​sgml·​&gt;​·​foo.​id.​xml</​code></​strong>
66 »       ​······​</​pre><p>Be·​prepared·​for·​a·​long·​list·​of·​"missing·​ID"·​error·​messages.​·​This·​is·​due·​to·​the·​fact·​that·​the·​elements·​with·​the·​IDs·​that·​the·​<code·​class="sgmltag-​element">xref</​code>·​elements·​in·​the·​citations·​point·​to·​do·​not·​yet·​exist,​·​they·​will·​be·​generated·​in·​the·​RefDB·​bibliography·​output.​·​If·​you·​process·​documents·​with·​more·​than·​200·​citations,​·​you'll·​have·​to·​increase·​the·​maximum·​error·​limit·​of·​Jade·​in·​order·​to·​obtain·​all·​IDs·​the·​first·​time.​·​After·​the·​first·​complete·​pass·​(including·​the·​steps·​outlined·​below)​,​·​Jade·​will·​only·​complain·​about·​any·​additional·​citations·​that·​you·​have·​inserted·​since·​the·​last·​run.​</​p><p>XML·​files·​are·​processed·​using·​your·​favourite·​XSL·​processor.​·​There·​are·​two·​different·​stylesheets·​available·​for·​raw·​and·​for·​cooked·​bibliographies.​·​Both·​work·​all·​the·​same·​for·​DTD-​based·​(DocBook·​4.​x,​·​TEI·​P4)​·​and·​schema-​based·​(DocBook·​5.​x,​·​TEI·​P5)​·​documents:​</​p><pre·​class="screen"·​width="60">66 »       ​······​</​pre><p>Be·​prepared·​for·​a·​long·​list·​of·​"missing·​ID"·​error·​messages.​·​This·​is·​due·​to·​the·​fact·​that·​the·​elements·​with·​the·​IDs·​that·​the·​<code·​class="sgmltag-​element">xref</​code>·​elements·​in·​the·​citations·​point·​to·​do·​not·​yet·​exist,​·​they·​will·​be·​generated·​in·​the·​RefDB·​bibliography·​output.​·​If·​you·​process·​documents·​with·​more·​than·​200·​citations,​·​you'll·​have·​to·​increase·​the·​maximum·​error·​limit·​of·​Jade·​in·​order·​to·​obtain·​all·​IDs·​the·​first·​time.​·​After·​the·​first·​complete·​pass·​(including·​the·​steps·​outlined·​below)​,​·​Jade·​will·​only·​complain·​about·​any·​additional·​citations·​that·​you·​have·​inserted·​since·​the·​last·​run.​</​p><p>XML·​files·​are·​processed·​using·​your·​favourite·​XSL·​processor.​·​There·​are·​two·​different·​stylesheets·​available·​for·​raw·​and·​for·​cooked·​bibliographies.​·​Both·​work·​all·​the·​same·​for·​DTD-​based·​(DocBook·​4.​x,​·​TEI·​P4)​·​and·​schema-​based·​(DocBook·​5.​x,​·​TEI·​P5)​·​documents:​</​p><pre·​class="screen"·​width="60">
67 »       ​»       ​<code·​class="prompt">#~·​</​code>67 »       ​»       ​<code·​class="prompt">#~·​</​code>
68 »       ​»       ​<strong·​class="userinput"><co​de>xsltproc·​-​-​catalogs·​-​-​xinclude·​/​usr/​local/​share/​xsl/​citations.​xsl··​foo.​xml·​&gt;​·​foo.​id.​xml</​code></​strong>68 »       ​»       ​<strong·​class="userinput"><co​de>xsltproc·​-​-​catalogs·​-​-​xinclude·​/​usr/​local/​share/​xsl/​citations.​xsl··​foo.​xml·​&gt;​·​foo.​id.​xml</​code></​strong>
69 »       ​»       ​<code·​class="prompt">#~·​</​code>69 »       ​»       ​<code·​class="prompt">#~·​</​code>
70 »       ​»       ​<strong·​class="userinput"><co​de>xsltproc·​-​-​catalogs·​-​-​xinclude·​/​usr/​local/​share/​xsl/​citationsraw.​xsl··​foo.​xml·​&gt;​·​foo.​id.​xml</​code></​strong>70 »       ​»       ​<strong·​class="userinput"><co​de>xsltproc·​-​-​catalogs·​-​-​xinclude·​/​usr/​local/​share/​xsl/​citationsraw.​xsl··​foo.​xml·​&gt;​·​foo.​id.​xml</​code></​strong>
Offset 75, 15 lines modifiedOffset 75, 15 lines modified
75 »       ​»       ​<strong·​class="userinput"><co​de>xmllint·​-​-​noout·​-​-​nonet·​-​-​dtdvalid·​file:​/​/​/​usr/​local/​share/​refdb/​dtd/​citationlistx.​dtd·​foo.​id.​xml</​code></​strong>75 »       ​»       ​<strong·​class="userinput"><co​de>xmllint·​-​-​noout·​-​-​nonet·​-​-​dtdvalid·​file:​/​/​/​usr/​local/​share/​refdb/​dtd/​citationlistx.​dtd·​foo.​id.​xml</​code></​strong>
76 »       ​······​</​pre></​li><li·​class="step"·​title="Create·​the·​bibliography·​file"><p·​class="title"><strong​>Create·​the·​bibliography·​file</​strong></​p><pre·​class="screen"·​width="60">76 »       ​······​</​pre></​li><li·​class="step"·​title="Create·​the·​bibliography·​file"><p·​class="title"><strong​>Create·​the·​bibliography·​file</​strong></​p><pre·​class="screen"·​width="60">
77 »       ​»       ​<code·​class="prompt">~$·​</​code>77 »       ​»       ​<code·​class="prompt">~$·​</​code>
78 »       ​»       ​<strong·​class="userinput"><co​de>refdbib·​-​d·​mybib·​-​S·​"J.​Irrep.​Res.​"·​-​t·​db31·​foo.​id.​xml·​&gt;​·​foo.​bib.​sgml</​code></​strong>78 »       ​»       ​<strong·​class="userinput"><co​de>refdbib·​-​d·​mybib·​-​S·​"J.​Irrep.​Res.​"·​-​t·​db31·​foo.​id.​xml·​&gt;​·​foo.​bib.​sgml</​code></​strong>
79 »       ​······​</​pre><p>This·​assumes·​that·​your·​reference·​database·​is·​called·​"mybib"·​and·​that·​you·​try·​to·​publish·​your·​paper·​in·​a·​journal·​that·​accepts·​the·​style·​with·​the·​name·​"J.​Irrep.​Res.​".​</​p><p>In·​addition·​to·​the·​bibliography·​file,​·​refdbib·​will·​also·​create·​a·​DSSSL·​script·​containing·​the·​style·​specification.​·​This·​file·​is·​a·​customized·​driver·​file·​for·​the·​RefDB-​DocBook·​driver·​files·​and·​provides·​a·​couple·​of·​variable·​values·​specific·​for·​the·​given·​bibliography·​style.​</​p><p>If·​you·​want·​to·​generate·​a·​raw·​bibliography,​·​use·​a·​command·​like·​this:​</​p><pre·​class="screen"·​width="60">79 »       ​······​</​pre><p>This·​assumes·​that·​your·​reference·​database·​is·​called·​"mybib"·​and·​that·​you·​try·​to·​publish·​your·​paper·​in·​a·​journal·​that·​accepts·​the·​style·​with·​the·​name·​"J.​Irrep.​Res.​".​</​p><p>In·​addition·​to·​the·​bibliography·​file,​·​refdbib·​will·​also·​create·​a·​DSSSL·​script·​containing·​the·​style·​specification.​·​This·​file·​is·​a·​customized·​driver·​file·​for·​the·​RefDB-​DocBook·​driver·​files·​and·​provides·​a·​couple·​of·​variable·​values·​specific·​for·​the·​given·​bibliography·​style.​</​p><p>If·​you·​want·​to·​generate·​a·​raw·​bibliography,​·​use·​a·​command·​like·​this:​</​p><pre·​class="screen"·​width="60">
80 »       ​»       ​<code·​class="prompt">~$·​</​code>80 »       ​»       ​<code·​class="prompt">~$·​</​code>
81 »       ​»       ​<strong·​class="userinput"><co​de>refdbib·​-​d·​mybib·​-​r·​-​t·​db50x·​foo.​id.​xml·​&gt;​·​foo.​bib.​xml</​code></​strong>81 »       ​»       ​<strong·​class="userinput"><co​de>refdbib·​-​d·​mybib·​-​r·​-​t·​db50x·​foo.​id.​xml·​&gt;​·​foo.​bib.​xml</​code></​strong>
82 »       ​······​</​pre></​li><li·​class="step"·​title="Post-​processing"><p·​class="title"><strong​>Post-​processing</​strong></​p><p>This·​step·​is·​only·​required·​for·​XML·​documents.​·​First·​we·​have·​to·​bring·​the·​stylesheets·​into·​shape,​·​and·​if·​it·​is·​a·​TEI·​document,​·​we'll·​also·​have·​to·​transform·​the·​bibliography·​file·​itself.​</​p><p>refdbib·​creates·​a·​general-​purpose·​XSL·​stylesheet·​which·​we·​need·​to·​turn·​into·​one·​FO·​and·​one·​HTML·​stylesheet.​·​Create·​two·​copies·​of·​the·​file.​·​If·​the·​stylesheet·​was·​e.​g.​·​<code·​class="filename">J.​Biol.​Chem.​xsl</​code>,​·​you·​need·​one·​copy·​named·​<code·​class="filename">J.​Biol.​Chem.​fo.​xsl</​code>·​and·​one·​copy·​named·​<code·​class="filename">J.​Biol.​Chem.​html.​xsl</​code>.​·​Scan·​the·​files·​for·​an·​import·​statement·​whose·​<code·​class="sgmltag-​attribute">href</​code>·​attribute·​is·​surrounded·​with·​two·​"&lt;​!-​-​·​REFDBSTYLESHEET·​-​-​&gt;​"·​comments.​·​The·​value·​of·​this·​attribute·​must·​be·​set·​to·​the·​full·​path·​of·​the·​corresponding·​original·​stylesheet·​(DocBook·​FO·​or·​HTML,​·​or·​TEI·​FO·​or·​HTML)​.​</​p><p>If·​you're·​working·​on·​a·​TEI·​P4·​XML·​document,​·​you'll··​✂82 »       ​······​</​pre></​li><li·​class="step"·​title="Post-​processing"><p·​class="title"><strong​>Post-​processing</​strong></​p><p>This·​step·​is·​only·​required·​for·​XML·​documents.​·​First·​we·​have·​to·​bring·​the·​stylesheets·​into·​shape,​·​and·​if·​it·​is·​a·​TEI·​document,​·​we'll·​also·​have·​to·​transform·​the·​bibliography·​file·​itself.​</​p><p>refdbib·​creates·​a·​general-​purpose·​XSL·​stylesheet·​which·​we·​need·​to·​turn·​into·​one·​FO·​and·​one·​HTML·​stylesheet.​·​Create·​two·​copies·​of·​the·​file.​·​If·​the·​stylesheet·​was·​e.​g.​·​<code·​class="filename">J.​Biol.​Chem.​xsl</​code>,​·​you·​need·​one·​copy·​named·​<code·​class="filename">J.​Biol.​Chem.​fo.​xsl</​code>·​and·​one·​copy·​named·​<code·​class="filename">J.​Biol.​Chem.​html.​xsl</​code>.​·​Scan·​the·​files·​for·​an·​import·​statement·​whose·​<code·​class="sgmltag-​attribute">href</​code>·​attribute·​is·​surrounded·​with·​two·​"&lt;​!-​-​·​REFDBSTYLESHEET·​-​-​&gt;​"·​comments.​·​The·​value·​of·​this·​attribute·​must·​be·​set·​to·​the·​full·​path·​of·​the·​corresponding·​original·​stylesheet·​(DocBook·​FO·​or·​HTML,​·​or·​TEI·​FO·​or·​HTML)​.​</​p><p>If·​you're·​working·​on·​a·​TEI·​P4·​XML·​document,​·​you'll··​✂
83 »       ​··​<code·​class="prompt">~$·​</​code>83 »       ​··​<code·​class="prompt">~$·​</​code>
84 »       ​··​<strong·​class="userinput"><co​de>refdbjade·​-​t·​html·​-​s·​J.​Irrep.​Res.​dsl·​foo.​sgml</​code></​strong>84 »       ​··​<strong·​class="userinput"><co​de>refdbjade·​-​t·​html·​-​s·​J.​Irrep.​Res.​dsl·​foo.​sgml</​code></​strong>
85 »       ​</​pre><pre·​class="screen"·​width="60">85 »       ​</​pre><pre·​class="screen"·​width="60">
86 »       ​··​<code·​class="prompt">~$·​</​code>86 »       ​··​<code·​class="prompt">~$·​</​code>
87 »       ​··​<strong·​class="userinput"><co​de>refdbxml·​-​t·​pdf·​-​s·​J.​Irrep.​Res.​fo.​xsl·​bar.​xml</​code></​strong>87 »       ​··​<strong·​class="userinput"><co​de>refdbxml·​-​t·​pdf·​-​s·​J.​Irrep.​Res.​fo.​xsl·​bar.​xml</​code></​strong>
88 »       ​</​pre><p>If·​you·​want·​to·​change·​the·​bibliography·​style·​of·​your·​document,​·​all·​you·​need·​to·​do·​is·​to·​rerun·​<span·​class="command"><stro​ng>runbib</​strong></​span>·​and·​<span·​class="command"><stro​ng>refdbjade</​strong></​span>·​or·​<span·​class="command"><stro​ng>refdbxml</​strong></​span>·​with·​the·​new·​parameters.​·​No·​changes·​to·​your·​DocBook·​source·​are·​necessary.​</​p><p>Processing·​your·​document·​with·​a·​raw·​bibliography·​does·​not·​differ·​from·​processing·​any·​other·​DocBook·​or·​TEI·​document.​·​However,​·​you·​can·​still·​use·​the·​<a·​class="link"·​href="re23.​html"·​title="refdbxml">refd​bxml</​a>·​script·​to·​avoid·​having·​to·​type·​the·​full·​command·​line·​of·​your·​XSL·​processor.​·​Use·​something·​like·​this·​to·​process·​a·​Docbook·​5.​0·​document·​with·​a·​raw·​bibliography:​</​p><pre·​class="screen"·​width="60">88 »       ​</​pre><p>If·​you·​want·​to·​change·​the·​bibliography·​style·​of·​your·​document,​·​all·​you·​need·​to·​do·​is·​to·​rerun·​<span·​class="command"><stro​ng>runbib</​strong></​span>·​and·​<span·​class="command"><stro​ng>refdbjade</​strong></​span>·​or·​<span·​class="command"><stro​ng>refdbxml</​strong></​span>·​with·​the·​new·​parameters.​·​No·​changes·​to·​your·​DocBook·​source·​are·​necessary.​</​p><p>Processing·​your·​document·​with·​a·​raw·​bibliography·​does·​not·​differ·​from·​processing·​any·​other·​DocBook·​or·​TEI·​document.​·​However,​·​you·​can·​still·​use·​the·​<a·​class="link"·​href="re23.​html"·​title="refdbxml">refd​bxml</​a>·​script·​to·​avoid·​having·​to·​type·​the·​full·​command·​line·​of·​your·​XSL·​processor.​·​Use·​something·​like·​this·​to·​process·​a·​Docbook·​5.​0·​document·​with·​a·​raw·​bibliography:​</​p><pre·​class="screen"·​width="60">
89 »       ​··​<code·​class="prompt">~$·​</​code>89 »       ​··​<code·​class="prompt">~$·​</​code>
/usr/local/share/doc/refdb/ch11s02.html
Offset 1, 4 lines modifiedOffset 1, 4 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>SRU·​Operations</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch11.​html"·​title="Chapter 11.​ RefDB·​SRU·​interface"·​/​><link·​rel="prev"·​href="ch11.​html"·​title="Chapter 11.​ RefDB·​SRU·​interface"·​/​><link·​rel="next"·​href="pt04.​html"·​title="Part IV.​ Reference·​manual"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">SRU·​Operations</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch11.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 11.​ RefDB·​SRU·​interface</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href="pt04.​·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>SRU·​Operations</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch11.​html"·​title="Chapter 11.​ RefDB·​SRU·​interface"·​/​><link·​rel="prev"·​href="ch11.​html"·​title="Chapter 11.​ RefDB·​SRU·​interface"·​/​><link·​rel="next"·​href="pt04.​html"·​title="Part IV.​ Reference·​manual"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">SRU·​Operations</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch11.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 11.​ RefDB·​SRU·​interface</​th><td·​width="20%"·​align="right"> <a·​accesskey="n"·​href="pt04.​·​✂
3 http:​/​/​myserver.​com/​cgi-​bin/​refdbsru/​foo?&lt;​query&gt;​3 http:​/​/​myserver.​com/​cgi-​bin/​refdbsru/​foo?&lt;​query&gt;​
4 »       ​</​pre><p>The·​first·​URL·​will·​use·​the·​default·​database.​·​The·​second·​URL·​will·​use·​the·​database·​"foo"·​instead.​·​The·​database·​name·​goes·​between·​the·​slash·​that·​follows·​the·​CGI·​script·​name·​and·​the·​question·​mark·​that·​opens·​the·​query·​string.​</​p></​div></​div><div·​class="sect2"·​title="The·​scan·​operation"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​id="sect-​sru-​scan"></​a>The·​scan·​operation</​h3></​div></​div></​div><p>The·​purpose·​of·​the·​scan·​operation·​is·​to·​provide·​a·​matching·​list·​of·​query·​terms,​·​along·​with·​the·​number·​of·​references·​each·​term·​would·​retrieve.​·​This·​is·​similar·​to·​browsing·​through·​a·​stack·​of·​library·​cards·​with·​subjects·​or·​author·​names·​on·​them.​·​The·​RefDB·​SRU·​service·​allows·​to·​scan·​the·​following·​database·​fields:​</​p><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>k​eywords·​(bib.​subject)​</​p><p>http:​/​/​mybox.​com/​cgi-​bin/​refdbsru/​?operation=scan&amp;​version=1.​1&amp;​scanClause=bib.​subject%3d%22dichrois​m%22</​p></​li><li·​class="listitem"><p>a​uthor·​names·​(bib.​name)​</​p><p>http:​/​/​m·​✂4 »       ​</​pre><p>The·​first·​URL·​will·​use·​the·​default·​database.​·​The·​second·​URL·​will·​use·​the·​database·​"foo"·​instead.​·​The·​database·​name·​goes·​between·​the·​slash·​that·​follows·​the·​CGI·​script·​name·​and·​the·​question·​mark·​that·​opens·​the·​query·​string.​</​p></​div></​div><div·​class="sect2"·​title="The·​scan·​operation"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​id="sect-​sru-​scan"></​a>The·​scan·​operation</​h3></​div></​div></​div><p>The·​purpose·​of·​the·​scan·​operation·​is·​to·​provide·​a·​matching·​list·​of·​query·​terms,​·​along·​with·​the·​number·​of·​references·​each·​term·​would·​retrieve.​·​This·​is·​similar·​to·​browsing·​through·​a·​stack·​of·​library·​cards·​with·​subjects·​or·​author·​names·​on·​them.​·​The·​RefDB·​SRU·​service·​allows·​to·​scan·​the·​following·​database·​fields:​</​p><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>k​eywords·​(bib.​subject)​</​p><p>http:​/​/​mybox.​com/​cgi-​bin/​refdbsru/​?operation=scan&amp;​version=1.​1&amp;​scanClause=bib.​subject%3d%22dichrois​m%22</​p></​li><li·​class="listitem"><p>a​uthor·​names·​(bib.​name)​</​p><p>http:​/​/​m·​✂
/usr/local/share/doc/refdb/ch14.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 14.​ Tools·​for·​reference·​and·​notes·​management</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt04.​html"·​title="Part IV.​ Reference·​manual"·​/​><link·​rel="prev"·​href="re10.​html"·​title="refdb-​bug"·​/​><link·​rel="next"·​href="re11.​html"·​title="refdbc"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 14.​ Tools·​for·​reference·​and·​notes·​management</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="re10.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​V.​ Reference·​manual</​th><td·​width="20%"·​align="right"> <a·​ac·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 14.​ Tools·​for·​reference·​and·​notes·​management</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt04.​html"·​title="Part IV.​ Reference·​manual"·​/​><link·​rel="prev"·​href="re10.​html"·​title="refdb-​bug"·​/​><link·​rel="next"·​href="re11.​html"·​title="refdbc"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 14.​ Tools·​for·​reference·​and·​notes·​management</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="re10.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part I​V.​ Reference·​manual</​th><td·​width="20%"·​align="right"> <a·​ac·​✂
/usr/local/share/doc/refdb/ch14s02.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Reference·​data·​output·​formats</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch14.​html"·​title="Chapter 14.​ Tools·​for·​reference·​and·​notes·​management"·​/​><link·​rel="prev"·​href="re18.​html"·​title="refdb_latex2ut​f8txt"·​/​><link·​rel="next"·​href="ch14s03.​html"·​title="Extended·​notes·​output·​formats"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Refere​nce·​data·​output·​formats</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="re18.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 14.​ Tools·​for·​reference·​and·​notes·​managem·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Reference·​data·​output·​formats</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch14.​html"·​title="Chapter 14.​ Tools·​for·​reference·​and·​notes·​management"·​/​><link·​rel="prev"·​href="re18.​html"·​title="refdb_latex2ut​f8txt"·​/​><link·​rel="next"·​href="ch14s03.​html"·​title="Extended·​notes·​output·​formats"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Refere​nce·​data·​output·​formats</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="re18.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 14.​ Tools·​for·​reference·​and·​notes·​managem·​✂
/usr/local/share/doc/refdb/ch14s03.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Extended·​notes·​output·​formats</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch14.​html"·​title="Chapter 14.​ Tools·​for·​reference·​and·​notes·​management"·​/​><link·​rel="prev"·​href="ch14s02.​html"·​title="Reference·​data·​output·​formats"·​/​><link·​rel="next"·​href="ch14s04.​html"·​title="The·​query·​language"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Extend​ed·​notes·​output·​formats</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch14s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 14.​ Tools·​for·​reference·​and·​notes·​ma·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Extended·​notes·​output·​formats</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch14.​html"·​title="Chapter 14.​ Tools·​for·​reference·​and·​notes·​management"·​/​><link·​rel="prev"·​href="ch14s02.​html"·​title="Reference·​data·​output·​formats"·​/​><link·​rel="next"·​href="ch14s04.​html"·​title="The·​query·​language"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Extend​ed·​notes·​output·​formats</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch14s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 14.​ Tools·​for·​reference·​and·​notes·​ma·​✂
/usr/local/share/doc/refdb/ch17.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 17.​ The·​RefDB·​database·​design</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt05.​html"·​title="Part V.​ Programmer's·​manual"·​/​><link·​rel="prev"·​href="ch16s13.​html"·​title="The·​table·​t_xlink"·​/​><link·​rel="next"·​href="ch17s02.​html"·​title="The·​table·​CITSTYLE"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 17.​ The·​RefDB·​database·​design</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch16s13.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part V​.​ Programmer's·​manual</​th><td·​width="20%"·​align="right"> <a·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 17.​ The·​RefDB·​database·​design</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt05.​html"·​title="Part V.​ Programmer's·​manual"·​/​><link·​rel="prev"·​href="ch16s13.​html"·​title="The·​table·​t_xlink"·​/​><link·​rel="next"·​href="ch17s02.​html"·​title="The·​table·​CITSTYLE"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 17.​ The·​RefDB·​database·​design</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch16s13.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part V​.​ Programmer's·​manual</​th><td·​width="20%"·​align="right"> <a·​✂
/usr/local/share/doc/refdb/ch18.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 18.​ RIS·​and·​risx·​format·​specifications</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt05.​html"·​title="Part V.​ Programmer's·​manual"·​/​><link·​rel="prev"·​href="ch17s05.​html"·​title="The·​table·​POSITION"·​/​><link·​rel="next"·​href="ch18s02.​html"·​title="The·​risx·​DTD"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 18.​ RIS·​and·​risx·​format·​specifications</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch17s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part V​.​ Programmer's·​manual</​th><td·​width="20%"·​alig·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 18.​ RIS·​and·​risx·​format·​specifications</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt05.​html"·​title="Part V.​ Programmer's·​manual"·​/​><link·​rel="prev"·​href="ch17s05.​html"·​title="The·​table·​POSITION"·​/​><link·​rel="next"·​href="ch18s02.​html"·​title="The·​risx·​DTD"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 18.​ RIS·​and·​risx·​format·​specifications</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch17s05.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part V​.​ Programmer's·​manual</​th><td·​width="20%"·​alig·​✂
/usr/local/share/doc/refdb/ch18s02.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>The·​risx·​DTD</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch18.​html"·​title="Chapter 18.​ RIS·​and·​risx·​format·​specifications"·​/​><link·​rel="prev"·​href="ch18.​html"·​title="Chapter 18.​ RIS·​and·​risx·​format·​specifications"·​/​><link·​rel="next"·​href="ch19.​html"·​title="Chapter 19.​ Using·​RefDB·​in·​your·​programs"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">The·​risx·​DTD</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch18.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 18.​ RIS·​and·​risx·​format·​specifications</​th><td·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>The·​risx·​DTD</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="ch18.​html"·​title="Chapter 18.​ RIS·​and·​risx·​format·​specifications"·​/​><link·​rel="prev"·​href="ch18.​html"·​title="Chapter 18.​ RIS·​and·​risx·​format·​specifications"·​/​><link·​rel="next"·​href="ch19.​html"·​title="Chapter 19.​ Using·​RefDB·​in·​your·​programs"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">The·​risx·​DTD</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch18.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Chapte​r 18.​ RIS·​and·​risx·​format·​specifications</​th><td·​✂
/usr/local/share/doc/refdb/ch19.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>
2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 19.​ Using·​RefDB·​in·​your·​programs</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt05.​html"·​title="Part V.​ Programmer's·​manual"·​/​><link·​rel="prev"·​href="ch18s02.​html"·​title="The·​risx·​DTD"·​/​><link·​rel="next"·​href="ch19s02.​html"·​title="Interfaces"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 19.​ Using·​RefDB·​in·​your·​programs</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch18s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part V​.​ Programmer's·​manual</​th><td·​width="20%"·​align="right"> <a·​access·​✂2 <!DOCTYPE·​html·​PUBLIC·​"-​/​/​W3C/​/​DTD·​XHTML·​1.​0·​Transitional/​/​EN"·​"http:​/​/​www.​w3.​org/​TR/​xhtml1/​DTD/​xhtml1-​transitional.​dtd"><html·​xmlns="http:​/​/​www.​w3.​org/​1999/​xhtml"><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=UTF-​8"·​/​><title>Chapter 19.​ Using·​RefDB·​in·​your·​programs</​title><link·​rel="stylesheet"·​type="text/​css"·​href="manual.​css"·​/​><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"·​/​><link·​rel="home"·​href="index.​html"·​title="RefDB·​handbook"·​/​><link·​rel="up"·​href="pt05.​html"·​title="Part V.​ Programmer's·​manual"·​/​><link·​rel="prev"·​href="ch18s02.​html"·​title="The·​risx·​DTD"·​/​><link·​rel="next"·​href="ch19s02.​html"·​title="Interfaces"·​/​></​head><body><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Chapte​r 19.​ Using·​RefDB·​in·​your·​programs</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ch18s02.​html">Prev</​a> </​td><th·​width="60%"·​align="center">Part V​.​ Programmer's·​manual</​th><td·​width="20%"·​align="right"> <a·​access·​✂
/usr/local/share/doc/refdb/ch19s02.html
Offset 1, 12 lines modifiedOffset 1, 12 lines modified
1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>1 <?xml·​version="1.​0"·​encoding="UTF-​8"·​standalone="no"?>