refdb-cvs Mailing List for RefDB (Page 36)
Status: Beta
Brought to you by:
mhoenicka
Menu
▾
▴
refdb-cvs — All cvs checkins go to this list
You can subscribe to this list here.
| 2003 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
(47) |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2004 |
Jan
(88) |
Feb
(50) |
Mar
(36) |
Apr
(9) |
May
(30) |
Jun
(30) |
Jul
(22) |
Aug
(16) |
Sep
(42) |
Oct
(18) |
Nov
(29) |
Dec
(23) |
| 2005 |
Jan
(18) |
Feb
(28) |
Mar
(21) |
Apr
(35) |
May
(62) |
Jun
(22) |
Jul
(5) |
Aug
(40) |
Sep
(98) |
Oct
(81) |
Nov
(51) |
Dec
(62) |
| 2006 |
Jan
(46) |
Feb
(36) |
Mar
(8) |
Apr
(16) |
May
(14) |
Jun
(16) |
Jul
(47) |
Aug
(60) |
Sep
(34) |
Oct
(16) |
Nov
(46) |
Dec
(11) |
| 2007 |
Jan
(16) |
Feb
(13) |
Mar
(58) |
Apr
(32) |
May
(4) |
Jun
(8) |
Jul
(31) |
Aug
(46) |
Sep
(22) |
Oct
(30) |
Nov
(58) |
Dec
(15) |
| 2008 |
Jan
(8) |
Feb
(8) |
Mar
(2) |
Apr
(6) |
May
(3) |
Jun
(2) |
Jul
(1) |
Aug
|
Sep
|
Oct
(6) |
Nov
(3) |
Dec
(5) |
| 2009 |
Jan
(1) |
Feb
(20) |
Mar
(8) |
Apr
(5) |
May
(8) |
Jun
(3) |
Jul
(6) |
Aug
(4) |
Sep
(7) |
Oct
(8) |
Nov
(2) |
Dec
(1) |
| 2010 |
Jan
(1) |
Feb
(4) |
Mar
|
Apr
|
May
(1) |
Jun
(1) |
Jul
|
Aug
(1) |
Sep
|
Oct
|
Nov
(1) |
Dec
|
| 2011 |
Jan
(5) |
Feb
(5) |
Mar
(13) |
Apr
(3) |
May
|
Jun
|
Jul
(4) |
Aug
|
Sep
(2) |
Oct
|
Nov
|
Dec
|
| 2012 |
Jan
(1) |
Feb
(1) |
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
(1) |
Oct
(5) |
Nov
|
Dec
(3) |
| 2013 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
(1) |
Dec
(13) |
| 2014 |
Jan
(2) |
Feb
(2) |
Mar
(2) |
Apr
(4) |
May
(1) |
Jun
(1) |
Jul
|
Aug
(6) |
Sep
(3) |
Oct
|
Nov
(2) |
Dec
|
| 2015 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
(3) |
Sep
|
Oct
(1) |
Nov
(1) |
Dec
|
| 2016 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
(2) |
Dec
|
| 2017 |
Jan
|
Feb
|
Mar
(5) |
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
|
| 2018 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
(1) |
Sep
|
Oct
|
Nov
|
Dec
|
| 2019 |
Jan
|
Feb
|
Mar
(1) |
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
|
| 2021 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
(1) |
Nov
|
Dec
|
| 2022 |
Jan
(9) |
Feb
(16) |
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
|
|
From: Markus H. <mho...@us...> - 2006-02-05 01:26:27
|
Update of /cvsroot/refdb/refdb/src In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv17487 Modified Files: Tag: Release_0_9_5_stable connect.c Log Message: send_status(): check return value of iwrite() correctly; read_status(): initialize status Index: connect.c =================================================================== RCS file: /cvsroot/refdb/refdb/src/connect.c,v retrieving revision 1.6.2.3 retrieving revision 1.6.2.4 diff -u -U2 -r1.6.2.3 -r1.6.2.4 --- connect.c 21 Apr 2005 21:11:24 -0000 1.6.2.3 +++ connect.c 5 Feb 2006 01:26:18 -0000 1.6.2.4 @@ -336,5 +336,6 @@ /* printf("sending status %d<< term:%d\n", n_status, n_term); */ - if (iwrite(fd, get_status_string(n_status), STATUS_LEN)) { + if (iwrite(fd, get_status_string(n_status), STATUS_LEN) == -1) { +/* printf("error sending status %d<< term:%d\n", n_status, n_term); */ return 1; } @@ -345,8 +346,10 @@ if (n_byte_written == -1) { +/* printf("error sending status %d<< term:%d\n", n_status, n_term); */ return 1; } } +/* printf("done sending status %d<< term:%d\n", n_status, n_term); */ return 0; } @@ -363,7 +366,9 @@ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*/ int read_status(int fd) { - char status[STATUS_LEN+1]; + char status[STATUS_LEN+1] = {'\0', '\0', '\0', '\0'}; +/* printf("receiving status...\n"); */ if (iread(fd, status, STATUS_LEN) != STATUS_LEN) { +/* printf("received status %s<<\n", status); */ return 1; } @@ -438,2 +443,3 @@ return "undefined error"; } + |
|
From: Markus H. <mho...@us...> - 2006-02-05 01:23:54
|
Update of /cvsroot/refdb/refdb/src In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv16744 Modified Files: Tag: Release_0_9_5_stable backend-risx.c Log Message: print empty part title instead of suppressing part element;output link elements after user and misc according to the dtd Index: backend-risx.c =================================================================== RCS file: /cvsroot/refdb/refdb/src/backend-risx.c,v retrieving revision 1.30.2.12 retrieving revision 1.30.2.13 diff -u -U2 -r1.30.2.12 -r1.30.2.13 --- backend-risx.c 3 Nov 2005 20:40:19 -0000 1.30.2.12 +++ backend-risx.c 5 Feb 2006 01:23:45 -0000 1.30.2.13 @@ -137,4 +137,5 @@ char id[32] = ""; char type[7] = "JOUR"; + char empty_string[1] = ""; char date_buffer[256]; char* new_ref; @@ -204,7 +205,6 @@ /* part title */ - if ((item = get_refdb_title_copy(ptr_rendinfo->dbires)) != NULL) { - nhave_buffer_data = 1; - + item = get_refdb_title_copy(ptr_rendinfo->dbires); + if (item != NULL) { if (print_element_x(item, &buffer, &buffer_len, "title", "type", "full", &xindent) == NULL) { free(buffer); @@ -214,4 +214,13 @@ free((char*)item); } + else { + if (print_element_x(empty_string, &buffer, &buffer_len, "title", "type", "full", &xindent) == NULL) { + free(buffer); + free((char*)item); + return 801; + } + } + nhave_buffer_data = 1; + if (add_authors_risx(&buffer, &buffer_len, conn, 1, ptr_rendinfo, &nhave_buffer_data, &xindent) == NULL) { @@ -847,42 +856,4 @@ /*----------------------------------------------------------------*/ - /* URL, L1 through L4 */ - - /* loop over all link types */ - for (i=0; i<5;i++) { - char ulink_type[10]; - dbi_result dbires; - - dbires = request_ulinks(conn, my_dbi_result_get_idval(ptr_rendinfo->dbires, "refdb_id"), 0 /* ref entry */, i /* link type */); - if (dbires == NULL) { - return NULL; - } - - while ((item = get_ulink(dbires)) != NULL) { - if (i == 0) { - strcpy(ulink_type, "url"); - } - else if (i == 1) { - strcpy(ulink_type, "pdf"); - } - else if (i == 2) { - strcpy(ulink_type, "fulltext"); - } - else if (i == 3) { - strcpy(ulink_type, "related"); - } - else if (i == 4) { - strcpy(ulink_type, "image"); - } - if (print_element_x(item, &buffer1, &buffer1_len, "link", "type", ulink_type, ptr_indent) == NULL) { - clean_request(dbires); - return NULL; - } - } - - clean_request(dbires); - } /* end for */ - - /*----------------------------------------------------------------*/ /* user1 */ if ((item = get_refdb_user1(ptr_rendinfo->dbires)) != NULL) { @@ -964,4 +935,42 @@ } + /*----------------------------------------------------------------*/ + /* URL, L1 through L4 */ + + /* loop over all link types */ + for (i=0; i<5;i++) { + char ulink_type[10]; + dbi_result dbires; + + dbires = request_ulinks(conn, my_dbi_result_get_idval(ptr_rendinfo->dbires, "refdb_id"), 0 /* ref entry */, i /* link type */); + if (dbires == NULL) { + return NULL; + } + + while ((item = get_ulink(dbires)) != NULL) { + if (i == 0) { + strcpy(ulink_type, "url"); + } + else if (i == 1) { + strcpy(ulink_type, "pdf"); + } + else if (i == 2) { + strcpy(ulink_type, "fulltext"); + } + else if (i == 3) { + strcpy(ulink_type, "related"); + } + else if (i == 4) { + strcpy(ulink_type, "image"); + } + if (print_element_x(item, &buffer1, &buffer1_len, "link", "type", ulink_type, ptr_indent) == NULL) { + clean_request(dbires); + return NULL; + } + } + + clean_request(dbires); + } /* end for */ + if (print_elend_x(&buffer1, &buffer1_len, "pubinfo", ptr_indent) == NULL) { free(buffer1); |
|
From: Paul A. H. <pau...@us...> - 2006-02-04 00:40:27
|
Update of /cvsroot/refdb/ports/freebsd In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv8183 Modified Files: Makefile Log Message: Updated PORTREVISION and expat2 version. Index: Makefile =================================================================== RCS file: /cvsroot/refdb/ports/freebsd/Makefile,v retrieving revision 1.9 retrieving revision 1.10 diff -u -U2 -r1.9 -r1.10 --- Makefile 3 Feb 2006 22:32:04 -0000 1.9 +++ Makefile 4 Feb 2006 00:40:20 -0000 1.10 @@ -8,4 +8,5 @@ PORTNAME= refdb PORTVERSION= 0.9.6 +PORTREVISION= 2 CATEGORIES= textproc MASTER_SITES= ${MASTER_SITE_SOURCEFORGE_EXTENDED} @@ -15,5 +16,5 @@ COMMENT= Bibliographic reference database -LIB_DEPENDS= expat.5:${PORTSDIR}/textproc/expat2 \ +LIB_DEPENDS= expat.6:${PORTSDIR}/textproc/expat2 \ dbi.0:${PORTSDIR}/databases/libdbi |
|
From: Paul A. H. <pau...@us...> - 2006-02-03 22:32:16
|
Update of /cvsroot/refdb/ports/freebsd In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv12764 Modified Files: Makefile Log Message: Removed a comment. Index: Makefile =================================================================== RCS file: /cvsroot/refdb/ports/freebsd/Makefile,v retrieving revision 1.8 retrieving revision 1.9 diff -u -U2 -r1.8 -r1.9 --- Makefile 3 Feb 2006 22:23:58 -0000 1.8 +++ Makefile 3 Feb 2006 22:32:04 -0000 1.9 @@ -24,5 +24,5 @@ CFLAGS+= -I${LOCALBASE}/include -# Change these: + CONFIGURE_ARGS+= --with-expat-lib=${LOCALBASE}/lib CONFIGURE_ARGS+= --with-classpath-root=${PREFIX}/share/java/classes |
|
From: Paul A. H. <pau...@us...> - 2006-02-03 22:26:51
|
Update of /cvsroot/refdb/ports/freebsd In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv9331 Modified Files: pkg-plist Log Message: Added some missing binaries to the list. I don't know how I missed these. Index: pkg-plist =================================================================== RCS file: /cvsroot/refdb/ports/freebsd/pkg-plist,v retrieving revision 1.4 retrieving revision 1.5 diff -u -U2 -r1.4 -r1.5 --- pkg-plist 16 Nov 2005 07:59:24 -0000 1.4 +++ pkg-plist 3 Feb 2006 22:26:43 -0000 1.5 @@ -91,18 +91,24 @@ etc/refdb/refdbxmlrc.example etc/refdb/refdbdrc.example +bin/db2ris +bin/eenc +bin/en2ris +bin/marc2ris +bin/med2ris +bin/nmed2ris bin/refdb-bug +bin/refdb-ms +bin/refdb_dos2unix +bin/refdb_tex2mail +bin/refdba +bin/refdbc bin/refdbctl -bin/refdbjade -bin/runbib -bin/db2ris -bin/refdbxml -bin/refdbnd bin/refdbd bin/refdbib -bin/refdbc -bin/refdba +bin/refdbjade +bin/refdbnd +bin/refdbxml bin/refdbxp -bin/nmed2ris -bin/eenc +bin/runbib @dirrm share/refdb/declarations @dirrm share/refdb/dsssl/html |
|
From: Paul A. H. <pau...@us...> - 2006-02-03 22:24:08
|
Update of /cvsroot/refdb/ports/freebsd In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv8615 Modified Files: Makefile Log Message: Added manual pages. Index: Makefile =================================================================== RCS file: /cvsroot/refdb/ports/freebsd/Makefile,v retrieving revision 1.7 retrieving revision 1.8 diff -u -U2 -r1.7 -r1.8 --- Makefile 24 Jan 2006 05:43:25 -0000 1.7 +++ Makefile 3 Feb 2006 22:23:58 -0000 1.8 @@ -36,4 +36,11 @@ CATALOG "Install SGML catalog" off +MAN1= bib2ris.1 db2ris.1 eenc.1 en2ris.1 marc2ris.1 med2ris.1 \ + refdb-backup.1 refdb-ms.1 refdb-restore.1 refdba.1 \ + refdbc.1 refdbctl.1 refdbd.1 refdbib.1 refdbjade.1 \ + refdbnd.1 refdbxml.1 refdbxp.1 runbib.1 +MAN7= RefDB.7 +MAN8= refdb.8 refdb.sh.8 + .include <bsd.port.pre.mk> |
|
From: Markus H. <mho...@us...> - 2006-02-02 22:38:40
|
Update of /cvsroot/refdb/refdb/src In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23771 Modified Files: Tag: Release_0_9_5_stable backend-dbiba.c Log Message: fixed crash if an url is missing Index: backend-dbiba.c =================================================================== RCS file: /cvsroot/refdb/refdb/src/backend-dbiba.c,v retrieving revision 1.26.2.20 retrieving revision 1.26.2.21 diff -u -U2 -r1.26.2.20 -r1.26.2.21 --- backend-dbiba.c 29 Dec 2005 19:39:43 -0000 1.26.2.20 +++ backend-dbiba.c 2 Feb 2006 22:38:31 -0000 1.26.2.21 @@ -1880,6 +1880,4 @@ if (!dbi_result_get_numrows(dbires_ulink)) { - clean_request(dbires); - /* return unaltered string */ return *ptr_ref; @@ -1911,5 +1909,4 @@ if ((new_ref = mstrcat(*ptr_ref, "<bibliomisc>", ptr_ref_len, 0)) == NULL) { LOG_PRINT(LOG_CRIT, get_status_msg(801)); - clean_request(dbires); return NULL; } @@ -1936,5 +1933,4 @@ if ((entitize_string = strdup(citem)) == NULL || sgml_entitize(&entitize_string, NULL) == NULL) { - clean_request(dbires); if (preceeding) { free(preceeding); @@ -1965,5 +1961,4 @@ if ((new_ref = mstrcat(*ptr_ref, start_tag, ptr_ref_len, 0)) == NULL) { LOG_PRINT(LOG_CRIT, get_status_msg(801)); - clean_request(dbires); if (preceeding) { free(preceeding); @@ -1980,5 +1975,4 @@ if ((new_ref = mstrcat(*ptr_ref, entitize_string, ptr_ref_len, 0)) == NULL) { LOG_PRINT(LOG_CRIT, get_status_msg(801)); - clean_request(dbires); if (preceeding) { free(preceeding); @@ -1997,5 +1991,4 @@ if ((new_ref = mstrcat(*ptr_ref, "</ulink>", ptr_ref_len, 0)) == NULL) { LOG_PRINT(LOG_CRIT, get_status_msg(801)); - clean_request(dbires); if (preceeding) { free(preceeding); @@ -2036,5 +2029,4 @@ if ((new_ref = mstrcat(*ptr_ref, "</bibliomisc>", ptr_ref_len, 0)) == NULL) { LOG_PRINT(LOG_CRIT, get_status_msg(801)); - clean_request(dbires); return NULL; } |
|
From: Paul A. H. <pau...@us...> - 2006-01-27 03:26:15
|
Update of /cvsroot/refdb/ports/freebsd In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv11519 Modified Files: distinfo Log Message: Added SHA256 checksum. Index: distinfo =================================================================== RCS file: /cvsroot/refdb/ports/freebsd/distinfo,v retrieving revision 1.2 retrieving revision 1.3 diff -u -U2 -r1.2 -r1.3 --- distinfo 16 Nov 2005 07:58:37 -0000 1.2 +++ distinfo 27 Jan 2006 03:26:07 -0000 1.3 @@ -1,2 +1,3 @@ MD5 (refdb-0.9.6.tar.gz) = 4e03995c0f9fffe50c7caf77be37cd82 +SHA256 (refdb-0.9.6.tar.gz) = 3acec14848dd07b028972e3a1ab680c681eacbf57e623e33d9743f197e90394d SIZE (refdb-0.9.6.tar.gz) = 2899044 |
|
From: Paul A. H. <pau...@us...> - 2006-01-24 05:43:35
|
Update of /cvsroot/refdb/ports/freebsd In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv21542 Modified Files: Makefile Log Message: It was noted that this port failed during FreeBSD's automatic build testing because there's a dependency on libiconv, but it's not explicitly named in the Makefile. 'USE_ICONV' fixes that. Index: Makefile =================================================================== RCS file: /cvsroot/refdb/ports/freebsd/Makefile,v retrieving revision 1.6 retrieving revision 1.7 diff -u -U2 -r1.6 -r1.7 --- Makefile 24 Jan 2006 05:31:21 -0000 1.6 +++ Makefile 24 Jan 2006 05:43:25 -0000 1.7 @@ -19,4 +19,5 @@ USE_GMAKE= yes +USE_ICONV= yes HAS_CONFIGURE= yes ALL_TARGET= |
|
From: Paul A. H. <pau...@us...> - 2006-01-24 05:31:29
|
Update of /cvsroot/refdb/ports/freebsd In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv17528 Modified Files: Makefile Log Message: Minor changes made by Volker Stolz <vs...@Fr...> on most recent commit to FreeBSD ports collection. This is really a temporary solution to the libdbi/libdbi-drivers problem. If the libdbi-drivers port is split into sub-ports in the future, we can fix this Makefile so that the RefDB port works under all circumstances instead of most. Index: Makefile =================================================================== RCS file: /cvsroot/refdb/ports/freebsd/Makefile,v retrieving revision 1.5 retrieving revision 1.6 diff -u -U2 -r1.5 -r1.6 --- Makefile 29 Nov 2005 01:27:34 -0000 1.5 +++ Makefile 24 Jan 2006 05:31:21 -0000 1.6 @@ -15,8 +15,7 @@ COMMENT= Bibliographic reference database -LIB_DEPENDS= expat.5:${PORTSDIR}/textproc/expat2 -BUILD_DEPENDS+= dbi>=0.8.1:${PORTSDIR}/databases/libdbi +LIB_DEPENDS= expat.5:${PORTSDIR}/textproc/expat2 \ + dbi.0:${PORTSDIR}/databases/libdbi -WRKSRC= ${WRKDIR}/refdb-0.9.6 USE_GMAKE= yes HAS_CONFIGURE= yes |
|
From: Markus H. <mho...@us...> - 2006-01-13 22:24:26
|
Update of /cvsroot/refdb/refdb/doc/include In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28841/include Modified Files: Tag: Release_0_9_5_stable manual-fo.xsl Log Message: use sans serif font for admonition titles Index: manual-fo.xsl =================================================================== RCS file: /cvsroot/refdb/refdb/doc/include/Attic/manual-fo.xsl,v retrieving revision 1.1.2.2 retrieving revision 1.1.2.3 diff -u -U2 -r1.1.2.2 -r1.1.2.3 --- manual-fo.xsl 12 Jan 2006 23:48:46 -0000 1.1.2.2 +++ manual-fo.xsl 13 Jan 2006 22:24:12 -0000 1.1.2.3 @@ -76,4 +76,12 @@ <xsl:param name="graphic.default.extension" select="'svg'"/> + <xsl:attribute-set name="admonition.title.properties"> + <xsl:attribute name="font-family"><xsl:value-of select="$title.fontset"/></xsl:attribute> + <xsl:attribute name="font-size">14pt</xsl:attribute> + <xsl:attribute name="font-weight">bold</xsl:attribute> + <xsl:attribute name="hyphenate">false</xsl:attribute> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> + </xsl:attribute-set> + </xsl:stylesheet> |
|
From: Markus H. <mho...@us...> - 2006-01-13 22:23:19
|
Update of /cvsroot/refdb/refdb/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28500 Modified Files: Tag: Release_0_9_5_stable manual.css Log Message: adapted to DocBook XML output Index: manual.css =================================================================== RCS file: /cvsroot/refdb/refdb/doc/Attic/manual.css,v retrieving revision 1.1.2.2 retrieving revision 1.1.2.3 diff -u -U2 -r1.1.2.2 -r1.1.2.3 --- manual.css 11 Dec 2005 20:24:55 -0000 1.1.2.2 +++ manual.css 13 Jan 2006 22:23:11 -0000 1.1.2.3 @@ -11,9 +11,9 @@ color: #006600} -tt.filename, tt.option {color: #660099; +code.filename, code.option {color: #660099; font-size: 110%; font-weight: bold;} -tt.sgmltag {color: #009966; +code.sgmltag, code.envar {color: #009966; font-size: 110%; font-weight: bold;} @@ -24,8 +24,11 @@ font-weight: bold;} -table.calstable th {color: #990000; +table th {color: #990000; font-weight: bold;} -table.warning {color: red;} +div.warning, div.warning h3.title {color: red;} + +pre.screen, pre.programlisting { + background-color: #E0E0E0; } span.guimenu, span.guimenuitem, span.guisubmenu { |
|
From: Markus H. <mho...@us...> - 2006-01-13 22:21:54
|
Update of /cvsroot/refdb/refdb/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28280 Modified Files: Tag: Release_0_9_5_stable chapter-refdba.xml chapter-refdbc.xml chapter-refdbd.xml chapter-refdbib.xml Log Message: changed title to include the non-client tools Index: chapter-refdba.xml =================================================================== RCS file: /cvsroot/refdb/refdb/doc/Attic/chapter-refdba.xml,v retrieving revision 1.1.2.1 retrieving revision 1.1.2.2 diff -u -U2 -r1.1.2.1 -r1.1.2.2 --- chapter-refdba.xml 8 Jan 2006 21:53:40 -0000 1.1.2.1 +++ chapter-refdba.xml 13 Jan 2006 22:21:46 -0000 1.1.2.2 @@ -1,6 +1,6 @@ <?xml version="1.0"?> <chapter id="chapter-refdba"> - <title>refdba: the administrative client</title> - <para>The following tasks can be performed with refdba:</para> + <title>Administration tools</title> + <para>The following tasks can be performed with the tools described in this chapter:</para> <itemizedlist> <listitem> @@ -22,6 +22,9 @@ <para>Configure the application server while running</para> </listitem> + <listitem> + <para>Create and restore database backups</para> + </listitem> </itemizedlist> - <para>The first section explains the usage of refdba in full detail. The following sections introduce two scripts which simplify the task of backing up and restoring the system and reference databases of your installation.</para> + <para>The first section explains the usage of the command-line client refdba in full detail. The following sections introduce two scripts which simplify the task of backing up and restoring the system and reference databases of your installation.</para> <xi:include href="refdba.1.xml" Index: chapter-refdbc.xml =================================================================== RCS file: /cvsroot/refdb/refdb/doc/Attic/chapter-refdbc.xml,v retrieving revision 1.1.2.1 retrieving revision 1.1.2.2 diff -u -U2 -r1.1.2.1 -r1.1.2.2 --- chapter-refdbc.xml 8 Jan 2006 21:53:40 -0000 1.1.2.1 +++ chapter-refdbc.xml 13 Jan 2006 22:21:46 -0000 1.1.2.2 @@ -1,9 +1,9 @@ <?xml version="1.0"?> <chapter id="chapter-refdbc"> - <title>refdbc: the reference management client</title> - <para>The following tasks can be performed with refdbc:</para> + <title>Tools for reference and notes management</title> + <para>The following tasks can be performed with the tools described in this chapter:</para> <itemizedlist> <listitem> - <para>Manually add, edit, and delete reference entries</para> + <para>Manually add, update, and delete reference entries</para> </listitem> <listitem> @@ -16,4 +16,7 @@ <para>Include existing references into personal reference list</para> </listitem> + <listitem> + <para>Convert reference data from various formats to RIS</para> + </listitem> </itemizedlist> Index: chapter-refdbd.xml =================================================================== RCS file: /cvsroot/refdb/refdb/doc/Attic/chapter-refdbd.xml,v retrieving revision 1.1.2.1 retrieving revision 1.1.2.2 diff -u -U2 -r1.1.2.1 -r1.1.2.2 --- chapter-refdbd.xml 8 Jan 2006 21:53:40 -0000 1.1.2.1 +++ chapter-refdbd.xml 13 Jan 2006 22:21:46 -0000 1.1.2.2 @@ -1,5 +1,5 @@ <?xml version="1.0"?> <chapter id="chapter-refdbd"> - <title>refdbd: the application server</title> + <title>The application server</title> <para>refdbd is the RefDB application server, i.e. a program that runs in the background and handles the requests from the RefDB clients. This is the program that directly interacts with the database server and does most of the serious work.</para> <para>refdbd can be configured at startup with the configuration file <filename moreinfo="none">refdbdrc</filename> or by passing command-line options. The latter override the corresponding settings in the configuration files. While refdbd is running, most of the parameters can be changed remotely with <application moreinfo="none">refdba</application> (see the refdba command <link linkend="app-a-command-confserv"><command moreinfo="none">confserv</command></link>), but to make changes permanent you'll have to edit the configuration file or the script line that starts refdbd.</para> Index: chapter-refdbib.xml =================================================================== RCS file: /cvsroot/refdb/refdb/doc/Attic/chapter-refdbib.xml,v retrieving revision 1.1.2.1 retrieving revision 1.1.2.2 diff -u -U2 -r1.1.2.1 -r1.1.2.2 --- chapter-refdbib.xml 8 Jan 2006 21:53:40 -0000 1.1.2.1 +++ chapter-refdbib.xml 13 Jan 2006 22:21:46 -0000 1.1.2.2 @@ -1,5 +1,5 @@ <?xml version="1.0"?> <chapter id="chapter-refdbib"> - <title>refdbib: the bibliography client</title> + <title>Tools for bibliographies</title> <para>This chapter is a reference for <command>refdbib</command>, the RefDB bibliography client, and all associated tools which are required for the transformation of documents containing RefDB bibliographies.</para> |
|
From: Markus H. <mho...@us...> - 2006-01-12 23:50:32
|
Update of /cvsroot/refdb/refdb/doc/include In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28795 Added Files: Tag: Release_0_9_5_stable fotitlepage.templates.xml Log Message: initial version --- NEW FILE --- <!DOCTYPE t:templates [ <!ENTITY hsize0 "10pt"> <!ENTITY hsize1 "12pt"> <!ENTITY hsize2 "14.4pt"> <!ENTITY hsize3 "17.28pt"> <!ENTITY hsize4 "20.736pt"> <!ENTITY hsize5 "24.8832pt"> <!ENTITY hsize0space "7.5pt"> <!-- 0.75 * hsize0 --> <!ENTITY hsize1space "9pt"> <!-- 0.75 * hsize1 --> <!ENTITY hsize2space "10.8pt"> <!-- 0.75 * hsize2 --> <!ENTITY hsize3space "12.96pt"> <!-- 0.75 * hsize3 --> <!ENTITY hsize4space "15.552pt"> <!-- 0.75 * hsize4 --> <!ENTITY hsize5space "18.6624pt"> <!-- 0.75 * hsize5 --> ]> <t:templates xmlns:t="http://nwalsh.com/docbook/xsl/template/1.0" xmlns:param="http://nwalsh.com/docbook/xsl/template/1.0/param" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> [...1198 lines suppressed...] font-weight="bold" font-family="{$title.fontset}"/> </t:titlepage-content> <t:titlepage-content t:side="verso"> </t:titlepage-content> <t:titlepage-separator> </t:titlepage-separator> <t:titlepage-before t:side="recto"> </t:titlepage-before> <t:titlepage-before t:side="verso"> </t:titlepage-before> </t:titlepage> <!-- ==================================================================== --> </t:templates> |
|
From: Markus H. <mho...@us...> - 2006-01-12 23:49:43
|
Update of /cvsroot/refdb/refdb/man In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28628/man Modified Files: Tag: Release_0_9_5_stable Makefile.am Log Message: changed distclean to maintainer-clean Index: Makefile.am =================================================================== RCS file: /cvsroot/refdb/refdb/man/Attic/Makefile.am,v retrieving revision 1.1.2.6 retrieving revision 1.1.2.7 diff -u -U2 -r1.1.2.6 -r1.1.2.7 --- Makefile.am 11 Jan 2006 00:16:27 -0000 1.1.2.6 +++ Makefile.am 12 Jan 2006 23:49:35 -0000 1.1.2.7 @@ -24,5 +24,5 @@ # sed 's%<etcpath>%$(DESTDIR)$(sysconfdir)/@PACKAGE@%' > $@ -distclean: +maintainer-clean: rm -f $(man_MANS) $(man1_MANS) |
|
From: Markus H. <mho...@us...> - 2006-01-12 23:49:11
|
Update of /cvsroot/refdb/refdb/doc/include In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28522/include Modified Files: Tag: Release_0_9_5_stable manual-xhtml.xsl Log Message: added params from xsltproc command-line Index: manual-xhtml.xsl =================================================================== RCS file: /cvsroot/refdb/refdb/doc/include/Attic/manual-xhtml.xsl,v retrieving revision 1.1.2.1 retrieving revision 1.1.2.2 diff -u -U2 -r1.1.2.1 -r1.1.2.2 --- manual-xhtml.xsl 8 Jan 2006 22:35:19 -0000 1.1.2.1 +++ manual-xhtml.xsl 12 Jan 2006 23:49:03 -0000 1.1.2.2 @@ -112,3 +112,8 @@ </xsl:template> + <!-- some overrides of parameters defined in param.xsl --> + <xsl:param name="html.stylesheet" select="'manual.css'"/> + <xsl:param name="funcsynopsis.style" select="'ansi'"/> + <xsl:param name="graphic.default.extension" select="'png'"/> + </xsl:stylesheet> |
|
From: Markus H. <mho...@us...> - 2006-01-12 23:48:53
|
Update of /cvsroot/refdb/refdb/doc/include In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28473/include Modified Files: Tag: Release_0_9_5_stable manual-fo.xsl Log Message: added params from xsltproc command-line;added color Index: manual-fo.xsl =================================================================== RCS file: /cvsroot/refdb/refdb/doc/include/Attic/manual-fo.xsl,v retrieving revision 1.1.2.1 retrieving revision 1.1.2.2 diff -u -U2 -r1.1.2.1 -r1.1.2.2 --- manual-fo.xsl 8 Jan 2006 22:35:19 -0000 1.1.2.1 +++ manual-fo.xsl 12 Jan 2006 23:48:46 -0000 1.1.2.2 @@ -6,87 +6,74 @@ <!-- driver file for the transformation of the RefDB manual to - xhtml. Most of the changes are related to properly integrating - refentries into the output - --> - <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/> - - <!-- - the following templates add refentries to the chapter TOCs + fo. Most of the changes are related to adding some + color to the output --> -<xsl:template match="sect1" mode="toc"> - <xsl:param name="toc-context" select="."/> - - <xsl:variable name="id"> - <xsl:call-template name="object.id"/> - </xsl:variable> - - <xsl:variable name="cid"> - <xsl:call-template name="object.id"> - <xsl:with-param name="object" select="$toc-context"/> - </xsl:call-template> - </xsl:variable> - - <xsl:call-template name="toc.line"/> - - <xsl:variable name="depth.from.context" select="count(ancestor::*)-count($toc-context/ancestor::*)"/> + <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/> + <xsl:include href="fotitlepages.xsl"/> - <xsl:if test="$toc.section.depth > 1 - and $toc.max.depth > $depth.from.context - and sect2"> - <fo:block id="toc.{$cid}.{$id}"> - <xsl:attribute name="margin-left"> - <xsl:call-template name="set.toc.indent"/> - </xsl:attribute> - - <xsl:apply-templates select="sect2|refentry" mode="toc"> - <xsl:with-param name="toc-context" select="$toc-context"/> - </xsl:apply-templates> + <xsl:attribute-set name="section.title.level1.properties"> + <xsl:attribute name="color">#009900</xsl:attribute> + </xsl:attribute-set> + + <xsl:attribute-set name="section.title.level2.properties"> + <xsl:attribute name="color">green</xsl:attribute> + </xsl:attribute-set> + + <xsl:attribute-set name="section.title.level3.properties"> + <xsl:attribute name="color">#006600</xsl:attribute> + </xsl:attribute-set> + + <xsl:template match="varlistentry" mode="vl.as.blocks"> + <xsl:variable name="id"> + <xsl:call-template name="object.id"/> + </xsl:variable> + + <fo:block id="{$id}" xsl:use-attribute-sets="list.item.spacing" + keep-together.within-column="always" + keep-with-next.within-column="always" + color="#990000"> + <xsl:apply-templates select="term"/> </fo:block> - </xsl:if> -</xsl:template> - -<xsl:template match="sect2" mode="toc"> - <xsl:param name="toc-context" select="."/> - <xsl:variable name="id"> - <xsl:call-template name="object.id"/> - </xsl:variable> - - <xsl:variable name="cid"> - <xsl:call-template name="object.id"> - <xsl:with-param name="object" select="$toc-context"/> - </xsl:call-template> - </xsl:variable> - - <xsl:call-template name="toc.line"/> - - <xsl:variable name="reldepth" - select="count(ancestor::*)-count($toc-context/ancestor::*)"/> - - <xsl:variable name="depth.from.context" select="count(ancestor::*)-count($toc-context/ancestor::*)"/> - - <xsl:if test="$toc.section.depth > 2 - and $toc.max.depth > $depth.from.context - and sect3"> - <fo:block id="toc.{$cid}.{$id}"> - <xsl:attribute name="margin-left"> - <xsl:call-template name="set.toc.indent"> - <xsl:with-param name="reldepth" select="$reldepth"/> - </xsl:call-template> - </xsl:attribute> - - <xsl:apply-templates select="sect3|refentry" mode="toc"> - <xsl:with-param name="toc-context" select="$toc-context"/> - </xsl:apply-templates> + <fo:block margin-left="0.25in"> + <xsl:apply-templates select="listitem"/> </fo:block> - </xsl:if> -</xsl:template> + </xsl:template> -<xsl:template match="refentry" mode="toc"> - <xsl:param name="toc-context" select="."/> + <xsl:template name="my.inline.monoseq"> + <xsl:param name="color">black</xsl:param> + <xsl:param name="content"> + <xsl:apply-templates/> + </xsl:param> + <fo:inline xsl:use-attribute-sets="monospace.properties" + color="{$color}"> + <xsl:if test="@dir"> + <xsl:attribute name="direction"> + <xsl:choose> + <xsl:when test="@dir = 'ltr' or @dir = 'lro'">ltr</xsl:when> + <xsl:otherwise>rtl</xsl:otherwise> + </xsl:choose> + </xsl:attribute> + </xsl:if> + <xsl:copy-of select="$content"/> + </fo:inline> + </xsl:template> + + <xsl:template match="filename"> + <xsl:call-template name="my.inline.monoseq"> + <xsl:with-param name="color">#660099</xsl:with-param> + </xsl:call-template> + </xsl:template> - <xsl:call-template name="toc.line"/> -</xsl:template> + <!-- some overrides of parameters defined in param.xsl --> + <xsl:param name="section.autolabel" select="1"/> + <xsl:param name="section.label.includes.component.label" select="1"/> + <xsl:param name="fop.extensions" select="1"/> + <xsl:param name="callout.unicode" select="1"/> + <xsl:param name="callout.graphics" select="0"/> + <xsl:param name="variablelist.as.blocks" select="1"/> + <xsl:param name="graphic.default.extension" select="'svg'"/> + </xsl:stylesheet> |
|
From: Markus H. <mho...@us...> - 2006-01-12 23:48:05
|
Update of /cvsroot/refdb/refdb/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28329 Modified Files: Tag: Release_0_9_5_stable refdbxp.1.xml Log Message: lower/mixed-cased section titles Index: refdbxp.1.xml =================================================================== RCS file: /cvsroot/refdb/refdb/doc/Attic/refdbxp.1.xml,v retrieving revision 1.1.2.1 retrieving revision 1.1.2.2 diff -u -U2 -r1.1.2.1 -r1.1.2.2 --- refdbxp.1.xml 8 Jan 2006 21:53:43 -0000 1.1.2.1 +++ refdbxp.1.xml 12 Jan 2006 23:47:58 -0000 1.1.2.2 @@ -3,5 +3,5 @@ <refentryinfo><date>2005-10-17</date></refentryinfo> <refmeta> - <refentrytitle>REFDBXP</refentrytitle> + <refentrytitle>refdbxp</refentrytitle> <manvolnum>1</manvolnum> <refmiscinfo class='date'>2005-10-17</refmiscinfo> @@ -24,5 +24,5 @@ <refsect1 id='refdbxp-description'> - <title>DESCRIPTION</title> + <title>Description</title> <para>refdbxp allows the interconversion of the short and full notation of citations in the supported SGML and XML documents of RefDB(7). See the RefDB manual (see below) for information about the two notations. The conversion is round-trip safe, and it supports mixing short and full notation in the same source document. Full-notation citations will use the correct encoding for first and subsequent citations of the same reference.</para> <note> @@ -52,5 +52,5 @@ <refsect1 id='refdbxp-options'> - <title>OPTIONS</title> + <title>Options</title> <variablelist remap='TP'> <varlistentry> @@ -76,5 +76,5 @@ <refsect1 id="refdbxp-example"> - <title>EXAMPLE</title> + <title>Example</title> <para>Lets first try the most common usage of refdbxp. The following command expands all citations, regardless of whether they are written in short or full notation, to the full notation and writes the result to a new file <filename moreinfo="none">foo.full.sgml</filename>. The input from <filename moreinfo="none">foo.sgml</filename> is assumed to be DocBook SGML:</para> <screen format="linespecific"> @@ -105,7 +105,7 @@ <refsect1 id='refdbxp-see_also'> - <title>SEE ALSO</title> + <title>See also</title> <para><emphasis remap='B'>RefDB</emphasis> (7), - <emphasis remap='B'><link linkend="refentry-refdbnd">refdbnd</link></emphasis> (1),</para> + <emphasis remap='B'><link linkend="refentry-refdbnd">refdbnd</link></emphasis> (1).</para> <para><emphasis remap='I'>RefDB manual (local copy) </emphasis> /usr/local/share/doc/refdb-0.9.7-pre1/index.html</para> @@ -117,5 +117,5 @@ <refsect1 id='refdbxp-author'> - <title>AUTHOR</title> + <title>Author</title> <para>refdbxp was written by Markus Hoenicka <ma...@mh...>.</para> |
|
From: Markus H. <mho...@us...> - 2006-01-12 23:47:40
|
Update of /cvsroot/refdb/refdb/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28247 Modified Files: Tag: Release_0_9_5_stable bib2ris.1.xml Log Message: removed doctype line Index: bib2ris.1.xml =================================================================== RCS file: /cvsroot/refdb/refdb/doc/Attic/bib2ris.1.xml,v retrieving revision 1.1.2.2 retrieving revision 1.1.2.3 diff -u -U2 -r1.1.2.2 -r1.1.2.3 --- bib2ris.1.xml 11 Jan 2006 00:12:29 -0000 1.1.2.2 +++ bib2ris.1.xml 12 Jan 2006 23:47:32 -0000 1.1.2.3 @@ -1,6 +1,3 @@ <?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" -"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> -<!-- lifted from troff+man by doclifter --> <refentry id="refentry-bib2ris"> <refentryinfo><date>2005-10-16</date></refentryinfo> |
|
From: Markus H. <mho...@us...> - 2006-01-12 23:46:12
|
Update of /cvsroot/refdb/refdb/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv27985 Modified Files: Tag: Release_0_9_5_stable Makefile.am Log Message: added include files;moved the params from the xsltproc command line to the driver files;changed distclean to maintainer-clean;build fotitlepages.xsl Index: Makefile.am =================================================================== RCS file: /cvsroot/refdb/refdb/doc/Attic/Makefile.am,v retrieving revision 1.1.2.12 retrieving revision 1.1.2.13 diff -u -U2 -r1.1.2.12 -r1.1.2.13 --- Makefile.am 9 Jan 2006 21:24:43 -0000 1.1.2.12 +++ Makefile.am 12 Jan 2006 23:46:04 -0000 1.1.2.13 @@ -43,4 +43,6 @@ xnoteelements_DATA = xnote/elements/* +#################################################################### +# the manual manual_sources = refdb-manual.xml chapter-backend-api.xml chapter-bibliographies.xml chapter-cs-protocol.xml chapter-data-input.xml chapter-inout-formats.xml chapter-installation.xml chapter-introduction.xml chapter-limitations.xml chapter-managing-notes.xml chapter-managing-references.xml chapter-overview-clients.xml chapter-perl-client-module.xml chapter-refdb-database-design.xml chapter-refdba.xml chapter-refdbc.xml chapter-refdbd-administration.xml chapter-refdbd.xml chapter-refdbib.xml chapter-reference-database-design.xml chapter-ris-risx-format.xml chapter-system-requirements.xml @@ -52,14 +54,19 @@ png_images = refdbmanualfig1.png refdbmanualfig2.png refdbmanualfig3.png refdbmanualfig4.png -#pdf_images = refdbmanualfig1.pdf refdbmanualfig2.pdf refdbmanualfig3.pdf refdbmanualfig4.pdf - html_extra_files = manual.css $(png_images) +manual_include_files = include/fotitlepage.templates.xml include/fotitlepages.xsl include/manual-fo.xsl include/manual-man.xsl include/manual-xhtml.xsl + +#################################################################### +# the dtd documentation dtdparsefiles = citestylex.xml citestylex/elements.html risx.xml risx/elements.html citationlistx.xml citationlistx/elements.html xnote.xml xnote/elements.html -EXTRA_DIST = $(doc_DATA) $(manual_sources) $(manpage_sources) $(html_extra_files) $(svg_images) $(citestylex_DATA) $(citestylexdtdelem_DATA) $(citestylexeledesc_DATA) $(citestylexelements_DATA) $(risx_DATA) $(risxdtdelem_DATA) $(risxeledesc_DATA) $(risxelements_DATA) $(citationlistx_DATA) $(citationlistxdtdelem_DATA) $(citationlistxeledesc_DATA) $(citationlistxelements_DATA) $(xnote_DATA) $(xnotedtdelem_DATA) $(xnoteeledesc_DATA) $(xnoteelements_DATA) $(index_DATA) $(dtdparsefiles) +EXTRA_DIST = $(doc_DATA) $(manual_sources) $(manpage_sources) $(html_extra_files) $(svg_images) $(citestylex_DATA) $(citestylexdtdelem_DATA) $(citestylexeledesc_DATA) $(citestylexelements_DATA) $(risx_DATA) $(risxdtdelem_DATA) $(risxeledesc_DATA) $(risxelements_DATA) $(citationlistx_DATA) $(citationlistxdtdelem_DATA) $(citationlistxeledesc_DATA) $(citationlistxelements_DATA) $(xnote_DATA) $(xnotedtdelem_DATA) $(xnoteeledesc_DATA) $(xnoteelements_DATA) $(index_DATA) $(dtdparsefiles) $(manual_include_files) all: refdb-manual.pdf refdb-manual/* citestylex/elements.html risx/elements.html citationlistx/elements.html xnote/elements.html +#################################################################### +# building the manual + # this is how we could validate the manual: # xmllint --noout --xinclude --relaxng /usr/local/share/emacs/21.3/site-lisp/nxml/schema/docbook.rng refdb-manual.xml 2>&1|less @@ -76,7 +83,11 @@ endif -refdb-manual.pdf: $(manual_sources) $(manpage_sources) $(svg_images) refdb-manual-statustable.xml +include/fotitlepages.xsl: include/fotitlepage.templates.xml + xsltproc -output include/fotitlepages.xsl $(docbk_xsl)/template/titlepage.xsl include/fotitlepage.templates.xml + +refdb-manual.pdf: $(manual_sources) $(manpage_sources) $(svg_images) refdb-manual-statustable.xml include/fotitlepages.xsl @echo "Creating PDF manual..."; - xsltproc -o refdb-manual.fo --nonet --xinclude --param section.autolabel 1 --param section.label.includes.component.label 1 --param fop.extensions 1 --param callout.unicode 1 --param callout.graphics 0 --stringparam graphic.default.extension "svg" $(docbk_xsl)/fo/docbook.xsl refdb-manual.xml + xsltproc -o refdb-manual.fo --nonet --xinclude $(top_srcdir)/doc/include/manual-fo.xsl refdb-manual.xml +# we have to give Java a little extra memory lest fop will die a horrible death JAVA_OPTS=-Xmx256M fop -fo refdb-manual.fo -pdf refdb-manual.pdf @@ -84,5 +95,9 @@ @echo "Creating HTML manual..."; rm -rf refdb-manual/* - mkdir -p refdb-manual && cp $(html_extra_files) refdb-manual/ && xsltproc -o refdb-manual/ --nonet --xinclude --stringparam html.stylesheet manual.css --stringparam funcsynopsis.style ansi --stringparam graphic.default.extension "png" $(top_srcdir)/doc/include/manual-xhtml.xsl refdb-manual.xml + mkdir -p refdb-manual && cp $(html_extra_files) refdb-manual/ && xsltproc -o refdb-manual/ --nonet --xinclude $(top_srcdir)/doc/include/manual-xhtml.xsl refdb-manual.xml + + +#################################################################### +# building the DTD doc citestylex.xml: $(top_srcdir)/dtd/citestylex.dtd @@ -128,8 +143,9 @@ xnote/elements/*: xnote/elements.html -distclean: clean +maintainer-clean: clean rm -f refdb-manual.pdf refdb-manual.tex refdb-manual.aux refdb-manual.log refdb-manual.out rm -rf refdb-manual/ rm -f $(png_images) + rm -f include/fotitlepages.xsl rm -f citestylex.xml risx.xml citationlistx.xml xnote.xml rm -f citestylex/*.html |
|
From: Markus H. <mho...@us...> - 2006-01-11 21:01:12
|
Update of /cvsroot/refdb/refdb/src In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv32481 Modified Files: Tag: Release_0_9_5_stable backend-bibtex.c Log Message: added school,institution,publisher output Index: backend-bibtex.c =================================================================== RCS file: /cvsroot/refdb/refdb/src/backend-bibtex.c,v retrieving revision 1.16.2.9 retrieving revision 1.16.2.10 diff -u -U2 -r1.16.2.9 -r1.16.2.10 --- backend-bibtex.c 3 Jan 2006 09:05:20 -0000 1.16.2.9 +++ backend-bibtex.c 11 Jan 2006 21:01:04 -0000 1.16.2.10 @@ -740,4 +740,55 @@ } + /*----------------------------------------------------------------*/ + /* publisher, school, institution */ + item = get_refdb_publisher(ptr_rendinfo->dbires); + if (item != NULL) { + char pubfield[20]; + + if (strcmp(type, "THES") == 0) { + strcpy(pubfield, " SCHOOL = {"); + } + else if (strcmp(type, "RPRT") == 0) { + strcpy(pubfield, " INSTITUTION = {"); + } + else { + strcpy(pubfield, " PUBLISHER = {"); + } + + if ((new_ref = mstrcat(*(ptr_rendinfo->ptr_ref), pubfield, ptr_rendinfo->ptr_ref_len, 0)) == NULL) { + unload_style(); + LOG_PRINT(LOG_CRIT, get_status_msg(801)); + if (!n_multiple_db) { + dbi_conn_close(bibconns.conn_refdb); + } + return 801; + } + else { + *(ptr_rendinfo->ptr_ref) = new_ref; + } + if ((new_ref = mstrcat(*(ptr_rendinfo->ptr_ref), (char*)item, ptr_rendinfo->ptr_ref_len, 0)) == NULL) { /* publisher */ + unload_style(); + LOG_PRINT(LOG_CRIT, get_status_msg(801)); + if (!n_multiple_db) { + dbi_conn_close(bibconns.conn_refdb); + } + return 801; + } + else { + *(ptr_rendinfo->ptr_ref) = new_ref; + } + if ((new_ref = mstrcat(*(ptr_rendinfo->ptr_ref), "},\n", ptr_rendinfo->ptr_ref_len, 0)) == NULL) { + unload_style(); + LOG_PRINT(LOG_CRIT, get_status_msg(801)); + if (!n_multiple_db) { + dbi_conn_close(bibconns.conn_refdb); + } + return 801; + } + else { + *(ptr_rendinfo->ptr_ref) = new_ref; + } + } + /* eliminate the trailing comma and finish with an empty line */ if ((new_ref = mstrcat(*(ptr_rendinfo->ptr_ref), "\n}\n", ptr_rendinfo->ptr_ref_len, 2)) == NULL) { |
|
From: Markus H. <mho...@us...> - 2006-01-11 00:16:36
|
Update of /cvsroot/refdb/refdb/man In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv20082/man Modified Files: Tag: Release_0_9_5_stable Makefile.am Log Message: turned clean into distclean Index: Makefile.am =================================================================== RCS file: /cvsroot/refdb/refdb/man/Attic/Makefile.am,v retrieving revision 1.1.2.5 retrieving revision 1.1.2.6 diff -u -U2 -r1.1.2.5 -r1.1.2.6 --- Makefile.am 11 Jan 2006 00:12:44 -0000 1.1.2.5 +++ Makefile.am 11 Jan 2006 00:16:27 -0000 1.1.2.6 @@ -24,5 +24,5 @@ # sed 's%<etcpath>%$(DESTDIR)$(sysconfdir)/@PACKAGE@%' > $@ -clean: +distclean: rm -f $(man_MANS) $(man1_MANS) |
|
From: Markus H. <mho...@us...> - 2006-01-11 00:12:52
|
Update of /cvsroot/refdb/refdb/man In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv18793/man Modified Files: Tag: Release_0_9_5_stable Makefile.am Log Message: make sure refdb.sh8 as an alias of refdb.8 is installed correctly Index: Makefile.am =================================================================== RCS file: /cvsroot/refdb/refdb/man/Attic/Makefile.am,v retrieving revision 1.1.2.4 retrieving revision 1.1.2.5 diff -u -U2 -r1.1.2.4 -r1.1.2.5 --- Makefile.am 8 Jan 2006 23:26:13 -0000 1.1.2.4 +++ Makefile.am 11 Jan 2006 00:12:44 -0000 1.1.2.5 @@ -4,7 +4,16 @@ man_MANS = RefDB.7 refdb.8 refdbd.1 refdba.1 refdbc.1 refdbib.1 bib2ris.1 db2ris.1 en2ris.1 marc2ris.1 med2ris.1 eenc.1 refdb-backup.1 refdb-ms.1 refdb-restore.1 refdbjade.1 refdbnd.1 refdbxml.1 runbib.1 refdbctl.1 refdbxp.1 -#man_MANS_in = RefDB.7.in refdb.8.in refdb.sh.8.in refdbd.1.in refdba.1.in refdbc.1.in refdbib.1.in bib2ris.1.in db2ris.1.in en2ris.1.in marc2ris.1.in med2ris.1.in eenc.1.in refdb-backup.1.in refdb-ms.1.in refdb-restore.1.in refdbjade.1.in refdbnd.1.in refdbxml.1.in runbib.1.in refdbctl.1.in refdbxp.1.in +# hack hack hack! refdb.sh.8 is automatically generated when we process +# refdb.8.xml. refdb and refdb.sh are synonyms. To keep the processing of +# the xml files simple, we can't include refdb.sh.8 into man_MANS. However, +# we can include it into man1_MANS so it will be installed ok. The +# dependency just makes sure man_MANS is processed before man1_MANS +man1_MANS = refdb.sh.8 -#EXTRA_DIST = $(man_MANS_in) +refdb.sh.8: refdb.8 + +EXTRA_DIST = $(man_MANS) $(man1_MANS) + +all: $(man_MANS) $(man1_MANS) $(man_MANS): %: $(top_srcdir)/doc/%.xml @@ -16,4 +25,4 @@ clean: - rm -f $(man_MANS) + rm -f $(man_MANS) $(man1_MANS) |
Update of /cvsroot/refdb/refdb/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv18137/doc Modified Files: Tag: Release_0_9_5_stable RefDB.7.xml bib2ris.1.xml db2ris.1.xml eenc.1.xml en2ris.1.xml marc2ris.1.xml med2ris.1.xml refdb-backup.1.xml refdb-dos2unix.1.xml refdb-ms.1.xml refdb-restore.1.xml refdb.8.xml refdba.1.xml refdbc.1.xml refdbctl.1.xml refdbd.1.xml refdbib.1.xml refdbjade.1.xml refdbnd.1.xml refdbxml.1.xml runbib.1.xml Log Message: lower/mixed-cased section titles - should have known the manpage stylesheets handle this themselves Index: RefDB.7.xml =================================================================== RCS file: /cvsroot/refdb/refdb/doc/Attic/RefDB.7.xml,v retrieving revision 1.1.2.1 retrieving revision 1.1.2.2 diff -u -U2 -r1.1.2.1 -r1.1.2.2 --- RefDB.7.xml 8 Jan 2006 22:03:15 -0000 1.1.2.1 +++ RefDB.7.xml 11 Jan 2006 00:12:29 -0000 1.1.2.2 @@ -1,299 +1,174 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> -<!-- lifted from troff+man by doclifter --> +"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> <refentry id='refdb7'> -<!-- Hey, EMACS: \-*\- nroff \-*\- --> -<!-- --> -<!-- Filename: <FILENAME> --> -<!-- Author: David Nebauer --> -<!-- History: <DATE> \- created --> -<!-- --> -<!-- For header (.TH), first parameter, NAME, should be all caps --> -<!-- Second parameter, SECTION, should be 1\-8, maybe w/ subsection --> -<!-- Other parameters are allowed: see man(7), man(1) --> -<!-- Please adjust the date whenever revising the manpage. --> -<!-- --> -<!-- Some roff macros, for reference: --> -<!-- .nh disable hyphenation --> -<!-- .hy enable hyphenation --> -<!-- .ad l left justify --> -<!-- .ad b justify to both left and right margins --> -<!-- .nf disable filling --> -<!-- .fi enable filling --> -<!-- .br insert line break --> -<!-- .sp <n> insert n+1 empty lines --> -<!-- for manpage\-specific macros, see man(7) --> -<!-- --> -<!-- Formatting [see groff_char (7) for details]: --> -<!-- ' : escape sequence for (') --> -<!-- `` : left/open double quote --> -<!-- '' : right/close double quote --> -<!-- ` : left/open single quote --> -<!-- ' : right/close single quote --> -<!-- — : escape sequence for em dash --> -<!-- – : escape sequence for en dash --> -<!-- \. : escape sequence for period/dot --> -<!-- \fX : escape sequence that changes font, where 'X' can be 'R|I|B|BI' --> -<!-- (R = roman/normal | I = italic | B = bold | BI = bold\-italic) --> -<!-- \fP : switch to previous font --> -<!-- in this case '\fR' could also have been used --> -<!-- --> -<!-- Bulleted list: --> -<!-- A bulleted list: --> -<!-- .IP • 2 --> -<!-- lawyers --> -<!-- .IP • --> -<!-- guns --> -<!-- .IP • --> -<!-- money --> -<!-- Numbered list: --> -<!-- .nr step 1 1 --> -<!-- A numbered list: --> -<!-- .IP \n[step] 3 --> -<!-- lawyers --> -<!-- .IP \n+[step] --> -<!-- guns --> -<!-- .IP \n+[step] --> -<!-- money --> -<refentryinfo><date>2005/10/16</date></refentryinfo> -<refmeta> -<refentrytitle>REFDB</refentrytitle> -<manvolnum>7</manvolnum> -<refmiscinfo class='date'>2005/10/16</refmiscinfo> -<refmiscinfo class='manual'>RefDB Manual</refmiscinfo> -</refmeta> -<refnamediv id='name'> -<refname>RefDB</refname> -<refpurpose>a set of tools to manage bibliographic references, notes, and bibliographies for markup languages</refpurpose> -</refnamediv> -<!-- body begins here --> - -<refsect1 id='description'><title>DESCRIPTION</title> - -<refsect2 id='general_features'><title>GENERAL FEATURES</title> -<variablelist remap='IP'> - <varlistentry> - <term>•</term> - <listitem> -<para>RefDB is a reference/notes database and bibliography tool for SGML, XML, and LaTeX documents.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>RefDB is mainly implemented in C, with a few Perl scripts inbetween, as well as shell scripts as "glue". It can be compiled on all platforms with a decent C compiler (a small amount of porting may be required). It builds and runs out of the box on Linux, FreeBSD, NetBSD, Solaris, OSX, Darwin, and Windows/Cygwin.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>RefDB is modular and accessible. You can plug in a variety of database engines to store your data, and you can choose between a variety of interfaces for interactive work. You can use RefDB in your projects through shell scripts or from Perl programs.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>The RefDB handbook (more than 300 printed pages) helps you to get RefDB up and running quickly and explains how to use the software for both administrators and users in great detail. In addition there is a tutorial targeted at plain users.</para> - </listitem> - </varlistentry> -</variablelist> -</refsect2> - -<refsect2 id='application_design'><title>APPLICATION DESIGN</title> -<variablelist remap='IP'> - <varlistentry> - <term>•</term> - <listitem> -<para>RefDB uses a SQL database engine to store the references, notes, and the bibliography styles. Choose either an external database server for optimum performance and flexibility, or an embedded database engine for convenience (see below for supported database engines).</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>Both reference and bibliography style databases use the relational features of SQL databases extensively to consolidate information and to save storage space.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>RefDB employs a three-tier architecture with lots of flexibility: clients, an application server that can run as a daemon, and the database server. If you prefer the embedded SQL engine, there'll be a two-tier setup. In both cases, all tiers may run on a single workstation for individual use.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>The application server can generate log messages to monitor its operation.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>RefDB contains two standard interfaces: a command line interface for terminal addicts and for use in scripts, and a PHP-based web interface for a more visual approach. In addition, both Emacs and Vim users can access RefDB from the editing environment they're used to. Finally, there is also a Perl client module to integrate RefDB functionality into your own Perl programs.</para> - </listitem> - </varlistentry> -</variablelist> -</refsect2> - -<refsect2 id='reference_and_notes_management'><title>REFERENCE AND NOTES MANAGEMENT</title> -<variablelist remap='IP'> - <varlistentry> - <term>•</term> - <listitem> -<para>The main input format for bibliographic data is RIS which can be generated and imported by all major reference databases on Windows (Reference Manager, EndNote and the like). An XML representation of RIS using the risx DTD is also supported as a native format. The latter is well suited as a means to import SGML or XML bibliographic data.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>Import filters are provided for Medline (tagged and XML), BibTeX, MARC, and DocBook.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>The data can be retrieved as simple text, formatted as HTML, formatted as a DocBook bibliography element (SGML or XML), formatted as a TEI listBibl element (XML), formatted as BibTeX reference list, or formatted as RIS or risx files.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>All character encodings supported by your platform can be used both for data input and for data export. This includes European character sets like Latin-1 and of course Unicode.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>Extended notes can be linked to one or more references, authors, periodicals, or keywords to create topics or material collections. These are more powerful and flexible than folder systems and the like.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>The query language is fairly simple yet powerful. You can use booleans to combine queries on any combination of fields. You can use brackets to group queries. You can use Unix-style regular expressions to formulate advanced queries.</para> - </listitem> - </varlistentry> -</variablelist> -</refsect2> - -<refsect2 id='bibliographies'><title>BIBLIOGRAPHIES</title> -<variablelist remap='IP'> - <varlistentry> - <term>•</term> - <listitem> -<para>Formatted bibliographies can be created automatically from DocBook SGML/XML and TEI XML documents. This does not require any changes or extensions to the DTDs. RefDB can also be integrated as a data source into the LaTeX/BibTeX workflow.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>RefDB is extensible in terms of the supported document types: support for new document types can be added without hacking the tool itself (you only need to hack stylesheets)</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>Citation and reference styles can be defined in XML to match the weirdest requirements of journals and publishers.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>Sophisticated shell scripts and makefiles take care of the document transformations. The whole process is transparent to the user as all he needs to do is e.g. type make pdf to turn his document into a PDF file with formatted citations and bibliographies.</para> - </listitem> - </varlistentry> -</variablelist> -</refsect2> - -<refsect2 id='networking_capabilities'><title>NETWORKING CAPABILITIES</title> -<variablelist remap='IP'> - <varlistentry> - <term>•</term> - <listitem> -<para>Due to the client/server design, RefDB is very well suited as a shared reference database for a workgroup or a department. However, it runs just fine on a single standalone workstation.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>Users can share databases and still have their personal reference lists. They can share their notes or keep them private on a per-note base.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>Concurrent read and write access of several users is supported. There is no need to restrict access of other users to read-only. However, if your database engine supports access control (MySQL and PostgreSQL), you can restrict access of some users to read-only.</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>A simple method to access electronic offprints (e.g. in PDF or PostScript format) is provided in the HTML output and in the web interface. This also works across networks using mounted shares.</para> - </listitem> - </varlistentry> -</variablelist> -</refsect2> - -<refsect2 id='supported_database_servers'><title>SUPPORTED DATABASE SERVERS</title> -<para>RefDB versions 0.9 and later employ the libdbi database abstraction library to provide support for different SQL database engines. -Currently the following external SQL database servers are supported:</para> -<variablelist remap='IP'> - <varlistentry> - <term>•</term> - <listitem> -<para>MySQL</para> - </listitem> - </varlistentry> - <varlistentry> - <term>•</term> - <listitem> -<para>PostgreSQL</para> - </listitem> - </varlistentry> -</variablelist> - -<para>The following embedded database engines are supported:</para> -<variablelist remap='IP'> - <varlistentry> - <term>•</term> - <listitem> -<para>SQLite (versions 2.x and 3.x)</para> - </listitem> - </varlistentry> -</variablelist> -</refsect2> -</refsect1> - -<refsect1 id='see_also'><title>SEE ALSO</title> -<para><emphasis remap='B'>refdbd</emphasis> (1), -<emphasis remap='B'>refdba</emphasis> (1), -<emphasis remap='B'>refdbc</emphasis> (1), -<emphasis remap='B'>refdbbib</emphasis> (1), -<emphasis remap='B'>bib2ris</emphasis> (1), -<emphasis remap='B'>db2ris</emphasis> (1), -<emphasis remap='B'>en2ris</emphasis> (1), -<emphasis remap='B'>marc2ris</emphasis> (1), -<emphasis remap='B'>med2ris</emphasis> (1), -<emphasis remap='B'>eenc</emphasis> (1), -<emphasis remap='B'>refdb-backup</emphasis> (1), -<emphasis remap='B'>refdb-ms</emphasis> (1), -<emphasis remap='B'>refdb-restore</emphasis> (1), -<emphasis remap='B'>refdbjade</emphasis> (1), -<emphasis remap='B'>refdbnd</emphasis> (1), -<emphasis remap='B'>refdbxml</emphasis> (1), -<emphasis remap='B'>refdbctl</emphasis> (1), -<emphasis remap='B'>refdb</emphasis> (8).</para> - -<para><emphasis remap='I'>RefDB manual (local copy) </emphasis> /usr/local/share/doc/refdb-0.9.7-pre1/index.html</para> - -<para><emphasis remap='I'>RefDB manual (web) </emphasis> <<ulink url='http://refdb.sourceforge.net/manual/index.html'>http://refdb.sourceforge.net/manual/index.html</ulink>></para> + <refentryinfo><date>2005/10/16</date></refentryinfo> + <refmeta> + <refentrytitle>RefDB</refentrytitle> + <manvolnum>7</manvolnum> + <refmiscinfo class='date'>2005/10/16</refmiscinfo> + <refmiscinfo class='manual'>RefDB Manual</refmiscinfo> + </refmeta> + <refnamediv id='name'> + <refname>RefDB</refname> + <refpurpose>a set of tools to manage bibliographic references, notes, and bibliographies for markup languages</refpurpose> + </refnamediv> + <!-- body begins here --> + + <refsect1 id='description'> + <title>Description</title> + + <refsect2 id='general_features'> + <title>General Features</title> + <itemizedlist remap='IP'> + <listitem> + <para>RefDB is a reference/notes database and bibliography tool for SGML, XML, and LaTeX documents.</para> + </listitem> + <listitem> + <para>RefDB is mainly implemented in C, with a few Perl scripts inbetween, as well as shell scripts as "glue". It can be compiled on all platforms with a decent C compiler (a small amount of porting may be required). It builds and runs out of the box on Linux, FreeBSD, NetBSD, Solaris, OSX, Darwin, and Windows/Cygwin.</para> + </listitem> + <listitem> + <para>RefDB is modular and accessible. You can plug in a variety of database engines to store your data, and you can choose between a variety of interfaces for interactive work. You can use RefDB in your projects through shell scripts or from Perl programs.</para> + </listitem> + <listitem> + <para>The RefDB handbook (more than 300 printed pages) helps you to get RefDB up and running quickly and explains how to use the software for both administrators and users in great detail. In addition there is a tutorial targeted at plain users.</para> + </listitem> + </itemizedlist> + </refsect2> + + <refsect2 id='application_design'> + <title>Application Design</title> + <itemizedlist remap='IP'> + <listitem> + <para>RefDB uses a SQL database engine to store the references, notes, and the bibliography styles. Choose either an external database server for optimum performance and flexibility, or an embedded database engine for convenience (see below for supported database engines).</para> + </listitem> + <listitem> + <para>Both reference and bibliography style databases use the relational features of SQL databases extensively to consolidate information and to save storage space.</para> + </listitem> + <listitem> + <para>RefDB employs a three-tier architecture with lots of flexibility: clients, an application server that can run as a daemon, and the database server. If you prefer the embedded SQL engine, there'll be a two-tier setup. In both cases, all tiers may run on a single workstation for individual use.</para> + </listitem> + <listitem> + <para>The application server can generate log messages to monitor its operation.</para> + </listitem> + <listitem> + <para>RefDB contains two standard interfaces: a command line interface for terminal addicts and for use in scripts, and a PHP-based web interface for a more visual approach. In addition, both Emacs and Vim users can access RefDB from the editing environment they're used to. Finally, there is also a Perl client module to integrate RefDB functionality into your own Perl programs.</para> + </listitem> + </itemizedlist> + </refsect2> + + <refsect2 id='reference_and_notes_management'> + <title>Reference and Notes Management</title> + <itemizedlist remap='IP'> + <listitem> + <para>The main input format for bibliographic data is RIS which can be generated and imported by all major reference databases on Windows (Reference Manager, EndNote and the like). An XML representation of RIS using the risx DTD is also supported as a native format. The latter is well suited as a means to import SGML or XML bibliographic data.</para> + </listitem> + <listitem> + <para>Import filters are provided for Medline (tagged and XML), BibTeX, MARC, and DocBook.</para> + </listitem> + <listitem> + <para>The data can be retrieved as simple text, formatted as HTML, formatted as a DocBook bibliography element (SGML or XML), formatted as a TEI listBibl element (XML), formatted as BibTeX reference list, or formatted as RIS or risx files.</para> + </listitem> + <listitem> + <para>All character encodings supported by your platform can be used both for data input and for data export. This includes European character sets like Latin-1 and of course Unicode.</para> + </listitem> + <listitem> + <para>Extended notes can be linked to one or more references, authors, periodicals, or keywords to create topics or material collections. These are more powerful and flexible than folder systems and the like.</para> + </listitem> + <listitem> + <para>The query language is fairly simple yet powerful. You can use booleans to combine queries on any combination of fields. You can use brackets to group queries. You can use Unix-style regular expressions to formulate advanced queries.</para> + </listitem> + </itemizedlist> + </refsect2> + + <refsect2 id='bibliographies'> + <title>Bibliographies</title> + <itemizedlist remap='IP'> + <listitem> + <para>Formatted bibliographies can be created automatically from DocBook SGML/XML and TEI XML documents. This does not require any changes or extensions to the DTDs. RefDB can also be integrated as a data source into the LaTeX/BibTeX workflow.</para> + </listitem> + <listitem> + <para>RefDB is extensible in terms of the supported document types: support for new document types can be added without hacking the tool itself (you only need to hack stylesheets)</para> + </listitem> + <listitem> + <para>Citation and reference styles can be defined in XML to match the weirdest requirements of journals and publishers.</para> + </listitem> + <listitem> + <para>Sophisticated shell scripts and makefiles take care of the document transformations. The whole process is transparent to the user as all he needs to do is e.g. type <command>make pdf</command> to turn his document into a PDF file with formatted citations and bibliographies.</para> + </listitem> + </itemizedlist> + </refsect2> + + <refsect2 id='networking_capabilities'> + <title>Networking Capabilities</title> + <itemizedlist remap='IP'> + <listitem> + <para>Due to the client/server design, RefDB is very well suited as a shared reference database for a workgroup or a department. However, it runs just fine on a single standalone workstation.</para> + </listitem> + <listitem> + <para>Users can share databases and still have their personal reference lists. They can share their notes or keep them private on a per-note base.</para> + </listitem> + <listitem> + <para>Concurrent read and write access of several users is supported. There is no need to restrict access of other users to read-only. However, if your database engine supports access control (MySQL and PostgreSQL), you can restrict access of some users to read-only.</para> + </listitem> + <listitem> + <para>A simple method to access electronic offprints (e.g. in PDF or PostScript format) is provided in the HTML output and in the web interface. This also works across networks using mounted shares.</para> + </listitem> + </itemizedlist> + </refsect2> + + <refsect2 id='supported_database_servers'> + <title>Supported Database Servers</title> + <para>RefDB versions 0.9 and later employ the libdbi database abstraction library to provide support for different SQL database engines. + Currently the following external SQL database servers are supported:</para> + <itemizedlist remap='IP'> + <listitem> + <para>MySQL</para> + </listitem> + <listitem> + <para>PostgreSQL</para> + </listitem> + </itemizedlist> + + <para>The following embedded database engines are supported:</para> + <itemizedlist remap='IP'> + <listitem> + <para>SQLite (versions 2.x and 3.x)</para> + </listitem> + </itemizedlist> + </refsect2> + </refsect1> + + <refsect1 id='see_also'><title>See also</title> + <para><emphasis remap='B'>refdbd</emphasis> (1), + <emphasis remap='B'>refdba</emphasis> (1), + <emphasis remap='B'>refdbc</emphasis> (1), + <emphasis remap='B'>refdbbib</emphasis> (1), + <emphasis remap='B'>bib2ris</emphasis> (1), + <emphasis remap='B'>db2ris</emphasis> (1), + <emphasis remap='B'>en2ris</emphasis> (1), + <emphasis remap='B'>marc2ris</emphasis> (1), + <emphasis remap='B'>med2ris</emphasis> (1), + <emphasis remap='B'>eenc</emphasis> (1), + <emphasis remap='B'>refdb-backup</emphasis> (1), + <emphasis remap='B'>refdb-ms</emphasis> (1), + <emphasis remap='B'>refdb-restore</emphasis> (1), + <emphasis remap='B'>refdbjade</emphasis> (1), + <emphasis remap='B'>refdbnd</emphasis> (1), + <emphasis remap='B'>refdbxml</emphasis> (1), + <emphasis remap='B'>refdbctl</emphasis> (1), + <emphasis remap='B'>refdb</emphasis> (8).</para> + + <para><emphasis remap='I'>RefDB manual (local copy) </emphasis> /usr/local/share/doc/refdb-0.9.7-pre1/index.html</para> + + <para><emphasis remap='I'>RefDB manual (web) </emphasis> <<ulink url='http://refdb.sourceforge.net/manual/index.html'>http://refdb.sourceforge.net/manual/index.html</ulink>></para> -<para><emphasis remap='I'>RefDB on the web </emphasis> <<ulink url='http://refdb.sourceforge.net/'>http://refdb.sourceforge.net/</ulink>></para> -</refsect1> + <para><emphasis remap='I'>RefDB on the web </emphasis> <<ulink url='http://refdb.sourceforge.net/'>http://refdb.sourceforge.net/</ulink>></para> + </refsect1> -<refsect1 id='author'><title>AUTHOR</title> -<para>RefDB was originally written by Markus Hoenicka <ma...@mh...>. For a list of current authors, see the file <filename>AUTHORS</filename>.</para> + <refsect1 id='author'><title>Author</title> + <para>RefDB was originally written by Markus Hoenicka <ma...@mh...>. For a list of current authors, see the file <filename>AUTHORS</filename>.</para> -</refsect1> + </refsect1> </refentry> Index: bib2ris.1.xml =================================================================== RCS file: /cvsroot/refdb/refdb/doc/Attic/bib2ris.1.xml,v retrieving revision 1.1.2.1 retrieving revision 1.1.2.2 diff -u -U2 -r1.1.2.1 -r1.1.2.2 --- bib2ris.1.xml 8 Jan 2006 22:32:40 -0000 1.1.2.1 +++ bib2ris.1.xml 11 Jan 2006 00:12:29 -0000 1.1.2.2 @@ -6,5 +6,5 @@ <refentryinfo><date>2005-10-16</date></refentryinfo> <refmeta> - <refentrytitle>BIB2RIS</refentrytitle> + <refentrytitle>bib2ris</refentrytitle> <manvolnum>1</manvolnum> <refmiscinfo class='date'>2005-10-16</refmiscinfo> @@ -32,8 +32,9 @@ - <refsect1 id='bib2ris-description2'><title>DESCRIPTION</title> - <para>bib2ris converts BibTeX bibliography files into RIS files.</para> + <refsect1 id='bib2ris-description2'> + <title>Description</title> + <para>bib2ris converts BibTeX bibliography files into RIS files.</para> - <para>Unfortunately the concepts underlying BibTeX and RIS bibliographic data are quite different so that BibTeX data do not readily lend themselves to a clean conversion to the RIS format. This is not meant as an excuse to provide a bad filter but you should be aware that a few compile-time assumptions have to be made in order to get reasonable results. In any case, as the data models differ considerably, a loss-free round-trip conversion between the two data types is not possible: If you convert a BibTeX bibliography file to RIS and then back, the result will differ considerably from your input.</para> + <para>Unfortunately the concepts underlying BibTeX and RIS bibliographic data are quite different so that BibTeX data do not readily lend themselves to a clean conversion to the RIS format. This is not meant as an excuse to provide a bad filter but you should be aware that a few compile-time assumptions have to be made in order to get reasonable results. In any case, as the data models differ considerably, a loss-free round-trip conversion between the two data types is not possible: If you convert a BibTeX bibliography file to RIS and then back, the result will differ considerably from your input.</para> <para>There are basically two ways how to handle BibTeX data with refdb:</para> <orderedlist inheritnum="ignore" continuation="restarts"> @@ -48,318 +49,319 @@ </refsect1> - <refsect1 id='bib2ris-options'><title>OPTIONS</title> - <variablelist remap='TP'> - <varlistentry> - <term><option>-e</option> <replaceable>log-destination</replaceable></term> - <listitem> - <para>log-destination can have the values 0, 1, or 2, or the equivalent strings <emphasis remap='I'>stderr</emphasis>, <emphasis remap='I'>syslog</emphasis>, or <emphasis remap='I'>file</emphasis>, respectively. This value specifies where the log information goes to. <literal>0</literal> (zero) means the messages are sent to stderr. They are immediately available on the screen but they may interfere with command output. <literal>1</literal> will send the output to the syslog facility. Keep in mind that syslog must be configured to accept log messages from user programs, see the syslog(8) man page for further information. Unix-like systems usually save these messages in <filename>/var/log/user.log</filename>. <literal>2</literal> will send the messages to a custom log file which can be specified with the <option>-L</option> option.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><option>-h</option></term> - <listitem> - <para>Displays help and usage screen, then exits.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><option>-j</option></term> - <listitem> - <para>Force bib2ris to use <emphasis remap='B'>JO</emphasis> RIS fields in all cases. If this option is not used, bib2ris tries to infer whether a journal name is an abbreviation or not. If the string contains at least one period, <emphasis remap='B'>JO</emphasis> will be used, otherwise <emphasis remap='B'>JF</emphasis> will be used.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><option>-l</option> <replaceable>log-level</replaceable></term> + <refsect1 id='bib2ris-options'> + <title>Options</title> + <variablelist remap='TP'> + <varlistentry> + <term><option>-e</option> <replaceable>log-destination</replaceable></term> + <listitem> + <para>log-destination can have the values 0, 1, or 2, or the equivalent strings <emphasis remap='I'>stderr</emphasis>, <emphasis remap='I'>syslog</emphasis>, or <emphasis remap='I'>file</emphasis>, respectively. This value specifies where the log information goes to. <literal>0</literal> (zero) means the messages are sent to stderr. They are immediately available on the screen but they may interfere with command output. <literal>1</literal> will send the output to the syslog facility. Keep in mind that syslog must be configured to accept log messages from user programs, see the syslog(8) man page for further information. Unix-like systems usually save these messages in <filename>/var/log/user.log</filename>. <literal>2</literal> will send the messages to a custom log file which can be specified with the <option>-L</option> option.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>-h</option></term> + <listitem> + <para>Displays help and usage screen, then exits.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>-j</option></term> + <listitem> + <para>Force bib2ris to use <emphasis remap='B'>JO</emphasis> RIS fields in all cases. If this option is not used, bib2ris tries to infer whether a journal name is an abbreviation or not. If the string contains at least one period, <emphasis remap='B'>JO</emphasis> will be used, otherwise <emphasis remap='B'>JF</emphasis> will be used.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>-l</option> <replaceable>log-level</replaceable></term> + <listitem> + <para>Specify the priority up to which events are logged. This is either a number between <literal>0</literal> and <literal>7</literal> or one of the strings <emphasis remap='I'>emerg</emphasis>, <emphasis remap='I'>alert</emphasis>, <emphasis remap='I'>crit</emphasis>, <emphasis remap='I'>err</emphasis>, <emphasis remap='I'>warning</emphasis>, <emphasis remap='I'>notice</emphasis>, <emphasis remap='I'>info</emphasis>, <emphasis remap='I'>debug</emphasis>, respectively (see also Log level definitions). <option>-1</option> disables logging completely. A low log level like <literal>0</literal> means that only the most critical messages are logged. A higher log level means that less critical events are logged as well. <literal>7</literal> will include debug messages. The latter can be verbose and abundant, so you want to avoid this log level unless you need to track down problems.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>-L</option> <replaceable>log-file</replaceable></term> + <listitem> + <para>Specify the full path to a log file that will receive the log messages. Typically this would be <filename>/var/log/refdba</filename>.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>-q</option></term> + <listitem> + <para>Start without reading the configuration files. The client will use the compile-time defaults for all values that you do not set with command-line switches.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>-s</option> <replaceable>separator</replaceable></term> + <listitem> + <para>Specify the delimiter which separates individual keywords in a non-standard keyword field. Use the string <emphasis remap='B'>spc</emphasis> for whitespace-separated lists (spaces and tabs).</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>-v</option></term> + <listitem> + <para>Prints version and copyright information, then exits.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>-y</option> <replaceable>confdir</replaceable></term> + <listitem> + <para>Specify the directory where the global configuration files are + Note: By default, all RefDB applications look for their configuration files in a directory that is specified during the configure step when building the package. That is, you don't need the <option>-y</option> option unless you use precompiled binaries in unusual locations, e.g. by relocating a rpm package.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='I'>file</emphasis></term> + <listitem> + <para>If used, this parameter denotes the names of one or more bibtex files. If no file is specified, bib2ris tries to read the data from stdin. Output is always sent to stdout.</para> + </listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Diagnostics</title> + <para>The exit code of <command moreinfo="none">bib2ris</command> indicates what went wrong in general (the details can be found in the log output). The code is the sum of the following error values:</para> + <variablelist> + <varlistentry> + <term><emphasis remap='I'>1</emphasis></term> + <listitem> + <para>general error; includes out of memory situations and invalid command-line options</para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='I'>2</emphasis></term> + <listitem> + <para>incomplete entry (at least one essential field in an entry was missing)</para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='I'>4</emphasis></term> + <listitem> + <para>unknown field name</para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='I'>8</emphasis></term> + <listitem> + <para>unknown publication type</para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='I'>16</emphasis></term> + <listitem> + <para>invalid BibTeX->RIS type mapping</para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='I'>32</emphasis></term> + <listitem> + <para>parse error; includes file access errors</para> + </listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1 id="bib2ris-configuration"> + <title>Configuration</title> + <para><command moreinfo="none">bib2ris</command> evaluates the file <filename moreinfo="none">bib2risrc</filename> to initialize itself.</para> + <table> + <title>bib2risrc</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Variable</entry> + <entry>Default</entry> + <entry>Comment</entry> + </row> + </thead> + <tbody> + <row> + <entry>logfile</entry> + <entry>/var/log/bib2ris.log</entry> + <entry>The full path of a custom log file. This is used only if logdest is set appropriately.</entry> + </row> + <row> + <entry>logdest</entry> + <entry>1</entry> + <entry>The destination of the log information. 0 = print to stderr; 1 = use the syslog facility; 2 = use a custom logfile. The latter needs a proper setting of logfile.</entry> + </row> + <row> + <entry>loglevel</entry> + <entry>6</entry> + <entry>The log level up to which messages will be sent. A low setting (0) allows only the most important messages, a high setting (7) allows all messages including debug messages. -1 means nothing will be logged.</entry> + </row> + <row> + <entry>abbrevfirst</entry> + <entry>t</entry> + <entry>If this option is set to "t", the first names of all authors and editors will be abbreviated to the initials. If set to "f", the first names will be used as they are found in the BibTeX bibliography file.</entry> + </row> + <row> + <entry>listsep</entry> + <entry>;</entry> + <entry>This is the delimiter which separates individual keywords in a non-standard keyword field. Use the string "spc" for whitespace-separated lists (spaces and tabs).</entry> + </row> + <row> + <entry>forcejabbrev</entry> + <entry>f</entry> + <entry>If this is set to "t", journal names will be wrapped in RIS "JO" entries. If it is set to "f", bib2ris will use "JO" entries only if the journal name contains at least one period, otherwise it will use "JF".</entry> + </row> + <row> + <entry>maparticle</entry> + <entry>JOUR</entry> + <entry>map the BibTeX article publication type to a RIS type</entry> + </row> + <row> + <entry>mapbook</entry> + <entry>BOOK</entry> + <entry>map the BibTeX book publication type to a RIS type</entry> + </row> + <row> + <entry>mapbooklet</entry> + <entry>PAMP</entry> + <entry>map the BibTeX booklet publication type to a RIS type</entry> + </row> + <row> + <entry>mapconference</entry> + <entry>CHAP</entry> + <entry>map the BibTeX conference publication type to a RIS type</entry> + </row> + <row> + <entry>mapinbook</entry> + <entry>CHAP</entry> + <entry>map the BibTeX inbook publication type to a RIS type</entry> + </row> + <row> + <entry>mapincollection</entry> + <entry>CHAP</entry> + <entry>map the BibTeX incollection publication type to a RIS type</entry> + </row> + <row> + <entry>mapinproceedings</entry> + <entry>CHAP</entry> + <entry>map the BibTeX inproceedings publication type to a RIS type</entry> + </row> + <row> + <entry>mapmanual</entry> + <entry>BOOK</entry> + <entry>map the BibTeX manual publication type to a RIS type</entry> + </row> + <row> + <entry>mapmastersthesis</entry> + <entry>THES</entry> + <entry>map the BibTeX mastersthesis publication type to a RIS type</entry> + </row> + <row> + <entry>mapmisc</entry> + <entry>GEN</entry> + <entry>map the BibTeX misc publication type to a RIS type</entry> + </row> + <row> + <entry>mapphdthesis</entry> + <entry>THES</entry> + <entry>map the BibTeX phdthesis publication type to a RIS type</entry> + </row> + <row> + <entry>mapproceedings</entry> + <entry>CONF</entry> + <entry>map the BibTeX proceedings publication type to a RIS type</entry> + </row> + <row> + <entry>maptechreport</entry> + <entry>RPRT</entry> + <entry>map the BibTeX techreport publication type to a RIS type</entry> + </row> + <row> + <entry>mapunpublished</entry> + <entry>UNPB</entry> + <entry>map the BibTeX unpublished publication type to a RIS type</entry> + </row> + <row> + <entry>nsf_xyz</entry> + <entry>(none)</entry> + <entry>You can specify an unlimited number of these entries to map non-standard BibTeX fields to RIS tags. The BibTeX field name in this variable has to be in lowercase, regardless of the case in your input data (bib2ris treats field names as case-insensitive). The two-letter RIS tag has to be in uppercase. E.g. to map your BibTeX "Abstract" field to the RIS "N2" tag, the entry would read: "nsf_abstract N2".</entry> + </row> + </tbody> + </tgroup> + </table> + </refsect1> + + <refsect1 id="bib2ris-data-processing"> + <title>Data Processing</title> + <para>This section provides a few hints about the data conversion itself and the BibTeX format requirements.</para> + <itemizedlist> <listitem> - <para>Specify the priority up to which events are logged. This is either a number between <literal>0</literal> and <literal>7</literal> or one of the strings <emphasis remap='I'>emerg</emphasis>, <emphasis remap='I'>alert</emphasis>, <emphasis remap='I'>crit</emphasis>, <emphasis remap='I'>err</emphasis>, <emphasis remap='I'>warning</emphasis>, <emphasis remap='I'>notice</emphasis>, <emphasis remap='I'>info</emphasis>, <emphasis remap='I'>debug</emphasis>, respectively (see also Log level definitions). <option>-1</option> disables logging completely. A low log level like <literal>0</literal> means that only the most critical messages are logged. A higher log level means that less critical events are logged as well. <literal>7</literal> will include debug messages. The latter can be verbose and abundant, so you want to avoid this log level unless you need to track down problems.</para> + <para>The parsing of the input data is done by the <filename moreinfo="none">btparse</filename> library. All limitations of that library apply to bib2ris as well. This applies very specifically to two hardcoded settings in <filename moreinfo="none">btparse</filename> which, simply put, limit the size and complexity (in terms of macros) of an input file that btparse can handle. If you run into this kind of problem (I had to pull a 2 MB BibTeX bibliography from the net in order to verify this limit) you should increase the values of <varname>NUM_MACROS</varname> and <varname>STRING_SIZE</varname> in the source file <filename moreinfo="none">macros.c</filename> and recompile the <filename moreinfo="none">btparse</filename> library.</para> </listitem> - </varlistentry> - <varlistentry> - <term><option>-L</option> <replaceable>log-file</replaceable></term> <listitem> - <para>Specify the full path to a log file that will receive the log messages. Typically this would be <filename>/var/log/refdba</filename>.</para> + <para>All entry names and field names in the BibTeX input file are treated as case-insensitive, i.e. "BoOk" is the same as "book" and "AUTHOR" is the same as "aUthoR".</para> </listitem> - </varlistentry> - <varlistentry> - <term><option>-q</option></term> <listitem> - <para>Start without reading the configuration files. The client will use the compile-time defaults for all values that you do not set with command-line switches.</para> + <para>The entries are checked for completeness. An error is generated if an entry lacks fields which are considered essential for the particular publication type.</para> </listitem> - </varlistentry> - <varlistentry> - <term><option>-s</option> <replaceable>separator</replaceable></term> <listitem> - <para>Specify the delimiter which separates individual keywords in a non-standard keyword field. Use the string <emphasis remap='B'>spc</emphasis> for whitespace-separated lists (spaces and tabs).</para> + <para>Non-standard fields can be imported in addition to the predefined BibTeX fields. Create an entry for each non-standard BibTeX field name that your input data use in your <link linkend="bib2ris-configuration">bib2ris configuration</link> file. The data are handled differently based on the type of RIS field they are imported to. If the data are imported to the RIS fields AD, N1, or N2, which basically have an unlimited size, all occurrences of these fields will be concatenated into a single AD, N1, or N2 tag line, respectively. If the data are mapped to the RIS KW field, the string will be tokenized based on the list separator specified in the listsep configuration variable. Each token will be written as a separate KW tag line. A special case is the RIS pseudo-field "PY.day". Data imported to this tag are integrated as the day part in the publication date tag line "PY" (year and month, but not day, are standard BibTeX fields and are recognized by default). All other fields will be printed with their requested RIS tag. It is at the discretion of any RIS importing application to decide what to do with duplicate tag lines. Multiples are allowed for author tags (AU, A2, A3) and the keyword tag (KW). refdb will use the <emphasis>last</emphasis> occurrence of a tag line that does not allow multiple occurrences.</para> </listitem> - </varlistentry> - <varlistentry> - <term><option>-v</option></term> <listitem> - <para>Prints version and copyright information, then exits.</para> + <para>Abbreviated journal names are detected only if they use periods. E.g. <quote>J. Biol. Chem.</quote> will be mapped to a "JO" RIS element whereas <quote>J Biol Chem</quote> will be (incorrectly) mapped to a "JF" element (<quote>Journal of Biological Chemistry</quote> would correctly end up here too). Spaces after periods are optional. To capture <quote>J Biol Chem</quote> in a "JO" element, use the <option>-j</option> command line option or the "forcejabbrev" configuration file variable.</para> </listitem> - </varlistentry> - <varlistentry> - <term><option>-y</option> <replaceable>confdir</replaceable></term> <listitem> - <para>Specify the directory where the global configuration files are - Note: By default, all RefDB applications look for their configuration files in a directory that is specified during the configure step when building the package. That is, you don't need the <option>-y</option> option unless you use precompiled binaries in unusual locations, e.g. by relocating a rpm package.</para> + <para>The mapping of BibTeX publication types (book, inproceedings...) to RIS types as specified in the configuration file is checked for valid RIS types. If an invalid RIS type is specified, an error is generated and the compile-time default is used instead.</para> </listitem> - </varlistentry> - <varlistentry> - <term><emphasis remap='I'>file</emphasis></term> <listitem> - <para>If used, this parameter denotes the names of one or more bibtex files. If no file is specified, bib2ris tries to read the data from stdin. Output is always sent to stdout.</para> + <para>By default the first names of authors and editors are not abbreviated. If you wish you can configure <command moreinfo="none">bib2ris</command> to abbreviate first and middle names.</para> </listitem> - </varlistentry> - </variablelist> -</refsect1> + </itemizedlist> + </refsect1> -<refsect1> - <title>DIAGNOSTICS</title> - <para>The exit code of <command moreinfo="none">bib2ris</command> indicates what went wrong in general (the details can be found in the log output). The code is the sum of the following error values:</para> - <variablelist> - <varlistentry> - <term><emphasis remap='I'>1</emphasis></term> - <listitem> - <para>general error; includes out of memory situations and invalid command-line options</para> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis remap='I'>2</emphasis></term> - <listitem> - <para>incomplete entry (at least one essential field in an entry was missing)</para> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis remap='I'>4</emphasis></term> - <listitem> - <para>unknown field name</para> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis remap='I'>8</emphasis></term> - <listitem> - <para>unknown publication type</para> - </listitem> - </varlistentry> + <refsect1 id="bib2ris-postprocessing"> + <title>Post-processing with tex2mail</title> + <para>refdb ships with a slightly modified version of the <command moreinfo="none">tex2mail</command> Perl script. The original purpose of this script is to convert (La)TeX input into a human-readable plain text file, taking care of various mathematical commands which can be rendered in multi-line output. In lieu of a better way to provide someting useful in no time I hacked this script to generate suitable RIS output when used with the proper command line switches. Without the <option>-ris</option> switch the script behaves just like the original tex2mail script. The purpose of this script in the context of refdb is to strip TeX commands and constructs from the RIS output that bib2ris generates.</para> + <warning> + <itemizedlist> + <listitem> + <para>This script is really a quick hack. It will be replaced by something more dedicated to its purpose (at least I'll maintain this illusion for the time being).</para> + </listitem> + <listitem> + <para>If you have LaTeX math formulas somewhere in the field values, strange and wondrous things are likely to happen. You will have to manually fix the output.</para> + </listitem> + </itemizedlist> + </warning> + <para>Run the script with the following command, assuming that <filename moreinfo="none">foo.ris</filename> is the output that you generated from your BibTeX bibliography file with the help of bib2ris:</para> + <screen format="linespecific"><prompt moreinfo="none">~# </prompt>tex2mail -noindent -ragged -linelength 65535 -ris < foo.ris > foo-notex.ris</screen> + <para>The argument of the <option>-linelength</option> option should be large enough to display each field in a single line, otherwise tex2mail tries to generate some simple layout which will screw up the RIS file.</para> + </refsect1> + + <refsect1 id='bib2ris-files'><title>Files</title> + <variablelist remap='TP'> <varlistentry> - <term><emphasis remap='I'>16</emphasis></term> + <term><filename>/usr/local/etc/refdb/bib2risrc</filename></term> <listitem> - <para>invalid BibTeX->RIS type mapping</para> + <para>The global configuration file of bib2ris.</para> </listitem> </varlistentry> <varlistentry> - <term><emphasis remap='I'>32</emphasis></term> + <term><filename>$HOME/.bib2risrc</filename></term> <listitem> - <para>parse error; includes file access errors</para> + <para>The user configuration file of bib2ris.</para> </listitem> </varlistentry> </variablelist> -</refsect1> + </refsect1> -<refsect1 id="bib2ris-configuration"> - <title>CONFIGURATION</title> - <para><command moreinfo="none">bib2ris</command> evaluates the file <filename moreinfo="none">bib2risrc</filename> to initialize itself.</para> - <table> - <title>bib2risrc</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Variable</entry> - <entry>Default</entry> - <entry>Comment</entry> - </row> - </thead> - <tbody> - <row> - <entry>logfile</entry> - <entry>/var/log/bib2ris.log</entry> - <entry>The full path of a custom log file. This is used only if logdest is set appropriately.</entry> - </row> - <row> - <entry>logdest</entry> - <entry>1</entry> - <entry>The destination of the log information. 0 = print to stderr; 1 = use the syslog facility; 2 = use a custom logfile. The latter needs a proper setting of logfile.</entry> - </row> - <row> - <entry>loglevel</entry> - <entry>6</entry> - <entry>The log level up to which messages will be sent. A low setting (0) allows only the most important messages, a high setting (7) allows all messages including debug messages. -1 means nothing will be logged.</entry> - </row> - <row> - <entry>abbrevfirst</entry> - <entry>t</entry> - <entry>If this option is set to "t", the first names of all authors and editors will be abbreviated to the initials. If set to "f", the first names will be used as they are found in the BibTeX bibliography file.</entry> - </row> - <row> - <entry>listsep</entry> - <entry>;</entry> - <entry>This is the delimiter which separates individual keywords in a non-standard keyword field. Use the string "spc" for whitespace-separated lists (spaces and tabs).</entry> - </row> - <row> - <entry>forcejabbrev</entry> - <entry>f</entry> - <entry>If this is set to "t", journal names will be wrapped in RIS "JO" entries. If it is set to "f", bib2ris will use "JO" entries only if the journal name contains at least one period, otherwise it will use "JF".</entry> - </row> - <row> - <entry>maparticle</entry> - <entry>JOUR</entry> - <entry>map the BibTeX article publication type to a RIS type</entry> - </row> - <row> - <entry>mapbook</entry> - <entry>BOOK</entry> - <entry>map the BibTeX book publication type to a RIS type</entry> - </row> - <row> - <entry>mapbooklet</entry> - <entry>PAMP</entry> - <entry>map the BibTeX booklet publication type to a RIS type</entry> - </row> - <row> - <entry>mapconference</entry> - <entry>CHAP</entry> - <entry>map the BibTeX conference publication type to a RIS type</entry> - </row> - <row> - <entry>mapinbook</entry> - <entry>CHAP</entry> - <entry>map the BibTeX inbook publication type to a RIS type</entry> - </row> - <row> - <entry>mapincollection</entry> - <entry>CHAP</entry> - <entry>map the BibTeX incollection publication type to a RIS type</entry> - </row> - <row> - <entry>mapinproceedings</entry> - <entry>CHAP</entry> - <entry>map the BibTeX inproceedings publication type to a RIS type</entry> - </row> - <row> - <entry>mapmanual</entry> - <entry>BOOK</entry> - <entry>map the BibTeX manual publication type to a RIS type</entry> - </row> - <row> - <entry>mapmastersthesis</entry> - <entry>THES</entry> - <entry>map the BibTeX mastersthesis publication type to a RIS type</entry> - </row> - <row> - <entry>mapmisc</entry> - <entry>GEN</entry> - <entry>map the BibTeX misc publication type to a RIS type</entry> - </row> - <row> - <entry>mapphdthesis</entry> - <entry>THES</entry> - <entry>map the BibTeX phdthesis publication type to a RIS type</entry> - </row> - <row> - <entry>mapproceedings</entry> - <entry>CONF</entry> - <entry>map the BibTeX proceedings publication type to a RIS type</entry> - </row> - <row> - <entry>maptechreport</entry> - <entry>RPRT</entry> - <entry>map the BibTeX techreport publication type to a RIS type</entry> - </row> - <row> - <entry>mapunpublished</entry> - <entry>UNPB</entry> - <entry>map the BibTeX unpublished publication type to a RIS type</entry> - </row> - <row> - <entry>nsf_xyz</entry> - <entry>(none)</entry> - <entry>You can specify an unlimited number of these entries to map non-standard BibTeX fields to RIS tags. The BibTeX field name in this variable has to be in lowercase, regardless of the case in your input data (bib2ris treats field names as case-insensitive). The two-letter RIS tag has to be in uppercase. E.g. to map your BibTeX "Abstract" field to the RIS "N2" tag, the entry would read: "nsf_abstract N2".</entry> - </row> - </tbody> - </tgroup> - </table> -</refsect1> - -<refsect1 id="bib2ris-data-processing"> - <title>DATA PROCESSING</title> - <para>This section provides a few hints about the data conversion itself and the BibTeX format requirements.</para> - <itemizedlist> - <listitem> - <para>The parsing of the input data is done by the <filename moreinfo="none">btparse</filename> library. All limitations of that library apply to bib2ris as well. This applies very specifically to two hardcoded settings in <filename moreinfo="none">btparse</filename> which, simply put, limit the size and complexity (in terms of macros) of an input file that btparse can handle. If you run into this kind of problem (I had to pull a 2 MB BibTeX bibliography from the net in order to verify this limit) you should increase the values of <varname>NUM_MACROS</varname> and <varname>STRING_SIZE</varname> in the source file <filename moreinfo="none">macros.c</filename> and recompile the <filename moreinfo="none">btparse</filename> library.</para> - </listitem> - <listitem> - <para>All entry names and field names in the BibTeX input file are treated as case-insensitive, i.e. "BoOk" is the same as "book" and "AUTHOR" is the same as "aUthoR".</para> - </listitem> - <listitem> - <para>The entries are checked for completeness. An error is generated if an entry lacks fields which are considered essential for the particular publication type.</para> - </listitem> - <listitem> - <para>Non-standard fields can be imported in addition to the predefined BibTeX fields. Create an entry for each non-standard BibTeX field name that your input data use in your <link linkend="bib2ris-configuration">bib2ris configuration</link> file. The data are handled differently based on the type of RIS field they are imported to. If the data are imported to the RIS fields AD, N1, or N2, which basically have an unlimited size, all occurrences of these fields will be concatenated into a single AD, N1, or N2 tag line, respectively. If the data are mapped to the RIS KW field, the string will be tokenized based on the list separator specified in the listsep configuration variable. Each token will be written as a separate KW tag line. A special case is the RIS pseudo-field "PY.day". Data imported to this tag are integrated as the day part in the publication date tag line "PY" (year and month, but not day, are standard BibTeX fields and are recognized by default). All other fields will be printed with their requested RIS tag. It is at the discretion of any RIS importing application to decide what to do with duplicate tag lines. Multiples are allowed for author tags (AU, A2, A3) and the keyword tag (KW). refdb will use the <emphasis>last</emphasis> occurrence of a tag line that does not allow multiple occurrences.</para> - </listitem> - <listitem> - <para>Abbreviated journal names are detected only if they use periods. E.g. <quote>J. Biol. Chem.</quote> will be mapped to a "JO" RIS element whereas <quote>J Biol Chem</quote> will be (incorrectly) mapped to a "JF" element (<quote>Journal of Biological Chemistry</quote> would correctly end up here too). Spaces after periods are optional. To capture <quote>J Biol Chem</quote> in a "JO" element, use the <option>-j</option> command line option or the "forcejabbrev" configuration file variable.</para> - </listitem> - <listitem> - <para>The mapping of BibTeX publication types (book, inproceedings...) to RIS types as specified in the configuration file is checked for valid RIS types. If an invalid RIS type is specified, an error is generated and the compile-time default is used instead.</para> - </listitem> - <listitem> - <para>By default the first names of authors and editors are not abbreviated. If you wish you can configure <command moreinfo="none">bib2ris</command> to abbreviate first and middle names.</para> - </listitem> - </itemizedlist> -</refsect1> - -<refsect1 id="bib2ris-postprocessing"> - <title>Post-processing with tex2mail</title> - <para>refdb ships with a slightly modified version of the <command moreinfo="none">tex2mail</command> Perl script. The original purpose of this script is to convert (La)TeX input into a human-readable plain text file, taking care of various mathematical commands which can be rendered in multi-line output. In lieu of a better way to provide someting useful in no time I hacked this script to generate suitable RIS output when used with the proper command line switches. Without the <option>-ris</option> switch the script behaves just like the original tex2mail script. The purpose of this script in the context of refdb is to strip TeX commands and constructs from the RIS output that bib2ris generates.</para> - <warning> - <itemizedlist> - <listitem> - <para>This script is really a quick hack. It will be replaced by something more dedicated to its purpose (at least I'll maintain this illusion for the time being).</para> - </listitem> - <listitem> - <para>If you have LaTeX math formulas somewhere in the field values, strange and wondrous things are likely to happen. You will have to manually fix the output.</para> - </listitem> - </itemizedlist> - </warning> - <para>Run the script with the following command, assuming that <filename moreinfo="none">foo.ris</filename> is the output that you generated from your BibTeX bibliography file with the help of bib2ris:</para> - <screen format="linespecific"><prompt moreinfo="none">~# </prompt>tex2mail -noindent -ragged -linelength 65535 -ris < foo.ris > foo-notex.ris</screen> - <para>The argument of the <option>-linelength</option> option should be large enough to display each field in a single line, otherwise tex2mail tries to generate some simple layout which will screw up the RIS file.</para> -</refsect1> - -<refsect1 id='bib2ris-files'><title>FILES</title> -<variablelist remap='TP'> - <varlistentry> - <term><filename>/usr/local/etc/refdb/bib2risrc</filename></term> - <listitem> - <para>The global configuration file of bib2ris.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis remap='I'>$HOME/.bib2risrc</emphasis></term> - <listitem> - <para>The user configuration file of bib2ris.</para> - </listitem> - </varlistentry> -</variablelist> -</refsect1> - -<refsect1 id='bib2ris-see_also2'><title>SEE ALSO</title> -<para><emphasis remap='B'>RefDB</emphasis> (7), -<emphasis remap='B'><link linkend="refentry-db2ris">db2ris</link></emphasis> (1). -<emphasis remap='B'><link linkend="refentry-en2ris">en2ris</link></emphasis> (1). -<emphasis remap='B'><link linkend="refentry-marc2ris">marc2ris</link></emphasis> (1). -<emph... [truncated message content] |
|
From: Markus H. <mho...@us...> - 2006-01-11 00:08:32
|
Update of /cvsroot/refdb/refdb In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv17044 Modified Files: Tag: Release_0_9_5_stable configure.in Log Message: build doc and man subdirs by default;changed --enable-docs to --disable-docs;bumped up version number Index: configure.in =================================================================== RCS file: /cvsroot/refdb/refdb/configure.in,v retrieving revision 1.49.2.28 retrieving revision 1.49.2.29 diff -u -U2 -r1.49.2.28 -r1.49.2.29 --- configure.in 26 Dec 2005 22:05:18 -0000 1.49.2.28 +++ configure.in 11 Jan 2006 00:08:24 -0000 1.49.2.29 @@ -10,5 +10,5 @@ dnl Use automake -AM_INIT_AUTOMAKE(refdb, 0.9.7-pre1) +AM_INIT_AUTOMAKE(refdb, 0.9.7-pre2) dnl switch on GNU extensions @@ -112,11 +112,13 @@ dnl see whether we should build the docs -ac_docs="NO" +ac_docs="YES" AC_ARG_ENABLE(docs, - [ --enable-docs Build the documentation.], - [ ac_docs="YES" ]) + [ --disable-docs do not build and install the documentation.], + [ ac_docs="NO" ]) if test "$ac_docs" = "YES"; then -docs_subdirs="doc" +docs_subdirs="doc man" +else +docs_subdirs="" fi |
1 message has been excluded from this view by a project administrator.
