/usr/local/poudriere/data/packages/e24a8cae34360705d022f17584bb6b4507b8eb89-build1/All/newsstar-1.5.6_1.txz vs.
/usr/local/poudriere/data/packages/e24a8cae34360705d022f17584bb6b4507b8eb89-build2/All/newsstar-1.5.6_1.txz
newsstar-1.5.6_1.txz-content
+MANIFEST
Offset 1, 1 lines modifiedOffset 1, 1 lines modified
1 {"name":​"newsstar",​"origin":​"news/​newsstar",​"version":​"1.​5.​6_1",​"comment":​"Transfer·​news·​between·​a·​local·​NNTP·​server·​(INN,​·​sn,​·​s-​news)​",​"maintainer":​"mandree@FreeBSD.​org",​"www":​"http:​/​/​newsstar.​sourceforge.​net/​",​"abi":​"FreeBSD:​11:​amd64",​"arch":​"freebsd:​11:​x86:​64",​"prefix":​"/​usr/​local",​"flatsize":​312174,​"licenselogic":​"single",​"licenses":​["GPLv3"],​"desc":​"Newsstar·​fetches·​news·​and·​posts·​it·​to·​a·​local·​server;​·​INN,​·​s-​news·​and·​sn·​are\nsupported,​·​and·​it·​should·​be·​easy·​to·​adapt·​for·​other·​servers·​with·​some\nconfiguration·​and·​extra·​scripts.​·​It's·​designed·​for·​Unix-​like·​systems,​·​and·​all\nthe·​development·​was·​done·​on·​Linux.​\n\nThere·​are·​already·​plenty·​of·​other·​programs·​to·​do·​this,​·​but·​what·​makes·​newsstar\nspecial·​is·​that·​it·​can·​make·​multiple·​simultaneous·​connections,​·​not·​only·​to\none·​server,​·​but·​to·​several,​·​supporting·​up·​to·​10·​threads.​·​Before·​fetching·​each\narticle·​it·​checks·​that·​it·​hasn't·​already·​been·​downloaded·​by·​another·​thread·​or\nin·​a·​previous·​session.​·​It·​can·​also·​pipeline·​article·​requests·​to·​make·​better\nuse·​of·​ava·​✂1 {"name":​"newsstar",​"origin":​"news/​newsstar",​"version":​"1.​5.​6_1",​"comment":​"Transfer·​news·​between·​a·​local·​NNTP·​server·​(INN,​·​sn,​·​s-​news)​",​"maintainer":​"mandree@FreeBSD.​org",​"www":​"http:​/​/​newsstar.​sourceforge.​net/​",​"abi":​"FreeBSD:​11:​amd64",​"arch":​"freebsd:​11:​x86:​64",​"prefix":​"/​usr/​local",​"flatsize":​312174,​"licenselogic":​"single",​"licenses":​["GPLv3"],​"desc":​"Newsstar·​fetches·​news·​and·​posts·​it·​to·​a·​local·​server;​·​INN,​·​s-​news·​and·​sn·​are\nsupported,​·​and·​it·​should·​be·​easy·​to·​adapt·​for·​other·​servers·​with·​some\nconfiguration·​and·​extra·​scripts.​·​It's·​designed·​for·​Unix-​like·​systems,​·​and·​all\nthe·​development·​was·​done·​on·​Linux.​\n\nThere·​are·​already·​plenty·​of·​other·​programs·​to·​do·​this,​·​but·​what·​makes·​newsstar\nspecial·​is·​that·​it·​can·​make·​multiple·​simultaneous·​connections,​·​not·​only·​to\none·​server,​·​but·​to·​several,​·​supporting·​up·​to·​10·​threads.​·​Before·​fetching·​each\narticle·​it·​checks·​that·​it·​hasn't·​already·​been·​downloaded·​by·​another·​thread·​or\nin·​a·​previous·​session.​·​It·​can·​also·​pipeline·​article·​requests·​to·​make·​better\nuse·​of·​ava·​✂
/usr/local/share/doc/newsstar/news.html
Offset 1, 8 lines modifiedOffset 1, 8 lines modified
1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=ISO-​8859-​1"><title>Newsstar·​News</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="article"·​title="Newsstar·​News"><div·​class="titlepage"><di​v><div><h2·​class="title"><a·​name="idp57925432"></​a>Newsstar·​News</​h2></​div></​div><hr></​div><div·​class="variablelist">​<dl><dt><span·​class="term">20·​January·​2013:​·​Version·​<span·​class="productnumber"​>1.​5.​6</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>U​se·​git·​instead·​of·​svn</​p></​li><li·​class="listitem"><p>R​epaired·​non-​pthreads·​implementation·​and·​made·​it·​default</​p></​li><li·​class="listitem"><p>K​eep·​recent·​versions·​of·​autotools·​happy</​p></​li></​ul></​div></​dd><dt><span·​class="term">23·​June·​2008:​·​Version·​<span·​class="productnumber"​>1.​5.​0</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​c·​✂1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=ISO-​8859-​1"><title>Newsstar·​News</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="article"·​title="Newsstar·​News"><div·​class="titlepage"><di​v><div><h2·​class="title"><a·​name="idp61116216"></​a>Newsstar·​News</​h2></​div></​div><hr></​div><div·​class="variablelist">​<dl><dt><span·​class="term">20·​January·​2013:​·​Version·​<span·​class="productnumber"​>1.​5.​6</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>U​se·​git·​instead·​of·​svn</​p></​li><li·​class="listitem"><p>R​epaired·​non-​pthreads·​implementation·​and·​made·​it·​default</​p></​li><li·​class="listitem"><p>K​eep·​recent·​versions·​of·​autotools·​happy</​p></​li></​ul></​div></​dd><dt><span·​class="term">23·​June·​2008:​·​Version·​<span·​class="productnumber"​>1.​5.​0</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​c·​✂
2 »       ​··​</​p></​li></​ul></​div></​dd><dt><span·​class="term">14·​October·​2007:​·​Version·​<span·​class="productnumber"​>1.​4.​0</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>A​llows·​character·​encoding·​of·​incoming·​messages·​to·​be·​changed2 »       ​··​</​p></​li></​ul></​div></​dd><dt><span·​class="term">14·​October·​2007:​·​Version·​<span·​class="productnumber"​>1.​4.​0</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>A​llows·​character·​encoding·​of·​incoming·​messages·​to·​be·​changed
3 »       ​··​</​p><p>I·​have·​shut·​down·​the·​mailing·​list·​due·​to·​an·​excess·​of·​spam3 »       ​··​</​p><p>I·​have·​shut·​down·​the·​mailing·​list·​due·​to·​an·​excess·​of·​spam
4 »       ​····​and·​dearth·​of·​genuine·​traffic</​p></​li></​ul></​div></​dd><dt><span·​class="term">26·​February·​2007:​·​Version·​<span·​class="productnumber"​>1.​3.​2</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>S​everal·​changes·​since·​I·​last·​remembered·​to·​update·​news</​p></​li></​ul></​div></​dd><dt><span·​class="term">1·​March·​2005:​·​Version·​<span·​class="productnumber"​>1.​2.​2</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>B​etter·​compatibility·​with·​old·​versions·​of·​BSD/​perl</​p></​li></​ul></​div></​dd><dt><span·​class="term">24·​August·​2004:​·​Version·​<span·​class="productnumber"​>1.​2.​1</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>F​ixed·​memory·​bug·​in·​1.​2's·​per-​group·​article·​counts</​p></​li><li·​class="listitem"><p>F​ixed·​Debian·​dependencies·​for·​Woody·​(3.​0·​stable)​</​p></​li><li·​class="listitem"><p>I​mproved·​docs·​about·​role·​of·​path·​option·​for·​header-​only4 »       ​····​and·​dearth·​of·​genuine·​traffic</​p></​li></​ul></​div></​dd><dt><span·​class="term">26·​February·​2007:​·​Version·​<span·​class="productnumber"​>1.​3.​2</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>S​everal·​changes·​since·​I·​last·​remembered·​to·​update·​news</​p></​li></​ul></​div></​dd><dt><span·​class="term">1·​March·​2005:​·​Version·​<span·​class="productnumber"​>1.​2.​2</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>B​etter·​compatibility·​with·​old·​versions·​of·​BSD/​perl</​p></​li></​ul></​div></​dd><dt><span·​class="term">24·​August·​2004:​·​Version·​<span·​class="productnumber"​>1.​2.​1</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>F​ixed·​memory·​bug·​in·​1.​2's·​per-​group·​article·​counts</​p></​li><li·​class="listitem"><p>F​ixed·​Debian·​dependencies·​for·​Woody·​(3.​0·​stable)​</​p></​li><li·​class="listitem"><p>I​mproved·​docs·​about·​role·​of·​path·​option·​for·​header-​only
5 »       ​··​scoring</​p></​li></​ul></​div></​dd><dt><span·​class="term">17·​August·​2004:​·​Version·​<span·​class="productnumber"​>1.​2</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>N​ew·​-​b·​(brief)​·​option</​p></​li><li·​class="listitem"><p>F​ixed·​sn·​overview·​bug·​and·​improved·​portability·​of·​perl·​script5 »       ​··​scoring</​p></​li></​ul></​div></​dd><dt><span·​class="term">17·​August·​2004:​·​Version·​<span·​class="productnumber"​>1.​2</​span></​span></​dt><dd><div·​class="itemizedlist">​<ul·​class="itemizedlist"·​type="disc"><li·​class="listitem"><p>N​ew·​-​b·​(brief)​·​option</​p></​li><li·​class="listitem"><p>F​ixed·​sn·​overview·​bug·​and·​improved·​portability·​of·​perl·​script
6 »       ​··​</​p></​li><li·​class="listitem"><p>S​everal·​new·​-​-​with-​*-​dir·​configure·​options·​aid·​portability6 »       ​··​</​p></​li><li·​class="listitem"><p>S​everal·​new·​-​-​with-​*-​dir·​configure·​options·​aid·​portability
7 »       ​··​</​p></​li><li·​class="listitem"><p>F​ixed·​missing·​server·​name·​in·​warning·​message·​about·​forcing7 »       ​··​</​p></​li><li·​class="listitem"><p>F​ixed·​missing·​server·​name·​in·​warning·​message·​about·​forcing
8 »       ​··​xover·​for·​scoring</​p></​li><li·​class="listitem"><p>F​ixed·​reporting·​of·​group·​name·​in·​message·​about·​backfills</​p></​li><li·​class="listitem"><p>E​mail·​address·​in·​HTML·​docs·​now·​obscured·​from·​spammers·​by8 »       ​··​xover·​for·​scoring</​p></​li><li·​class="listitem"><p>F​ixed·​reporting·​of·​group·​name·​in·​message·​about·​backfills</​p></​li><li·​class="listitem"><p>E​mail·​address·​in·​HTML·​docs·​now·​obscured·​from·​spammers·​by
/usr/local/share/doc/newsstar/index.html
Offset 1, 10 lines modifiedOffset 1, 10 lines modified
1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Newssta​r</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="next"·​href="ar01s02.​html"·​title="News"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><p><a​·​href="http:​/​/​sourceforge.​net/​projects/​newsstar/​"><img·​src="http:​/​/​sourceforge.​net/​sflogo.​php?group_id=92322&am​p;​type=4"·​width="125"·​height="37"·​border="0"·​alt="SourceForge.​net·​Logo"·​/​></​a></​p><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Newsst​ar</​th></​tr><tr><td·​width="20%"·​align="left">&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s02.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="article"·​title="Newsstar"><div​·​class="titlepage"><di​v><div><h2·​class="title"><a·​name="idp63109944"></​a>Newsstar</​h2></​div><div><div·​cl·​✂1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Newssta​r</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="next"·​href="ar01s02.​html"·​title="News"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><p><a​·​href="http:​/​/​sourceforge.​net/​projects/​newsstar/​"><img·​src="http:​/​/​sourceforge.​net/​sflogo.​php?group_id=92322&am​p;​type=4"·​width="125"·​height="37"·​border="0"·​alt="SourceForge.​net·​Logo"·​/​></​a></​p><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Newsst​ar</​th></​tr><tr><td·​width="20%"·​align="left">&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s02.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="article"·​title="Newsstar"><div​·​class="titlepage"><di​v><div><h2·​class="title"><a·​name="idp63585080"></​a>Newsstar</​h2></​div><div><div·​cl·​✂
2 <span·​class="productnumber"​>0.​7.​0</​span></​a></​span></​dt></​dl></​dd><dt><span·​class="sect1"><a·​href="ar01s08.​html">How·​it·​works</​a></​span></​dt><dd><dl><dt><span·​class="sect2"><a·​href="ar01s08.​html#idp63404856">Pre​paring·​articles·​for·​upload</​a></​span></​dt><dt><span·​class="sect2"><a·​href="ar01s08.​html#idp63408696">Run​ning·​the·​binary,​·​processing·​downloaded·​articles,​·​clearing2 <span·​class="productnumber"​>0.​7.​0</​span></​a></​span></​dt></​dl></​dd><dt><span·​class="sect1"><a·​href="ar01s08.​html">How·​it·​works</​a></​span></​dt><dd><dl><dt><span·​class="sect2"><a·​href="ar01s08.​html#idp63851320">Pre​paring·​articles·​for·​upload</​a></​span></​dt><dt><span·​class="sect2"><a·​href="ar01s08.​html#idp63855160">Run​ning·​the·​binary,​·​processing·​downloaded·​articles,​·​clearing
3 up</​a></​span></​dt></​dl></​dd><dt><span·​class="sect1"><a·​href="ar01s09.​html">Migrating·​from·​suck</​a></​span></​dt><dt><span·​class="sect1"><a·​href="ar01s10.​html">Score-​based·​killfiling</​a></​span></​dt><dt><span·​class="sect1"><a·​href="ar01s11.​html">Interrupting·​while·​running</​a></​span></​dt><dt><span·​class="sect1"><a·​href="ar01s12.​html">Contact·​details</​a></​span></​dt></​dl></​div><div·​class="sect1"·​title="Introduction">​<div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63127992"></​a>Introduction</​h2></​div></​div></​div><p><span·​class="application">N​ewsstar</​span>·​fetches·​news·​and·​posts·​it·​to·​a·​local3 up</​a></​span></​dt></​dl></​dd><dt><span·​class="sect1"><a·​href="ar01s09.​html">Migrating·​from·​suck</​a></​span></​dt><dt><span·​class="sect1"><a·​href="ar01s10.​html">Score-​based·​killfiling</​a></​span></​dt><dt><span·​class="sect1"><a·​href="ar01s11.​html">Interrupting·​while·​running</​a></​span></​dt><dt><span·​class="sect1"><a·​href="ar01s12.​html">Contact·​details</​a></​span></​dt></​dl></​div><div·​class="sect1"·​title="Introduction">​<div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63607224"></​a>Introduction</​h2></​div></​div></​div><p><span·​class="application">N​ewsstar</​span>·​fetches·​news·​and·​posts·​it·​to·​a·​local
4 server;​·​<span·​class="application">I​NN</​span>,​·​<span·​class="application">s​-​news</​span>·​and4 server;​·​<span·​class="application">I​NN</​span>,​·​<span·​class="application">s​-​news</​span>·​and
5 <span·​class="application">s​n</​span>·​are·​supported,​·​and·​it·​should·​be·​easy·​to·​adapt·​for5 <span·​class="application">s​n</​span>·​are·​supported,​·​and·​it·​should·​be·​easy·​to·​adapt·​for
6 other·​servers·​with·​some·​configuration·​and·​extra·​scripts.​·​It's·​designed·​for6 other·​servers·​with·​some·​configuration·​and·​extra·​scripts.​·​It's·​designed·​for
7 Unix-​like·​systems,​·​and·​all·​the·​development·​was·​done·​on·​Linux.​</​p><p>There·​are·​already·​plenty·​of·​other·​programs·​to·​do·​this,​·​but·​what·​makes7 Unix-​like·​systems,​·​and·​all·​the·​development·​was·​done·​on·​Linux.​</​p><p>There·​are·​already·​plenty·​of·​other·​programs·​to·​do·​this,​·​but·​what·​makes
8 <span·​class="application">n​ewsstar</​span>·​special·​is·​that·​it·​can·​make·​multiple8 <span·​class="application">n​ewsstar</​span>·​special·​is·​that·​it·​can·​make·​multiple
9 simultaneous·​connections,​·​not·​only·​to·​one·​server,​·​but·​to·​several,​·​supporting·​up9 simultaneous·​connections,​·​not·​only·​to·​one·​server,​·​but·​to·​several,​·​supporting·​up
10 to·​10·​<em·​class="firstterm">thr​eads</​em>.​·​Before·​fetching·​each·​article·​it·​checks10 to·​10·​<em·​class="firstterm">thr​eads</​em>.​·​Before·​fetching·​each·​article·​it·​checks
Offset 17, 15 lines modifiedOffset 17, 15 lines modified
17 available,​·​but·​use·​the·​foreign·​server·​to·​avoid·​missing·​posts·​or·​getting·​them17 available,​·​but·​use·​the·​foreign·​server·​to·​avoid·​missing·​posts·​or·​getting·​them
18 very·​late,​·​and·​to·​do·​it·​as·​fast·​as·​possible.​</​p><p>Newsstar·​is·​distributed·​under·​the·​<em·​class="firstterm">GPL​</​em>.​·​If·​you18 very·​late,​·​and·​to·​do·​it·​as·​fast·​as·​possible.​</​p><p>Newsstar·​is·​distributed·​under·​the·​<em·​class="firstterm">GPL​</​em>.​·​If·​you
19 are·​reading·​this·​file·​offline·​you·​should·​have·​a·​file·​called19 are·​reading·​this·​file·​offline·​you·​should·​have·​a·​file·​called
20 <code·​class="filename">COPY​ING</​code>·​with·​details.​··​Due·​to·​a·​long-​term·​illness·​I·​am20 <code·​class="filename">COPY​ING</​code>·​with·​details.​··​Due·​to·​a·​long-​term·​illness·​I·​am
21 unable·​to·​earn·​a·​living,​·​either·​by·​programming·​or·​by·​any·​other·​means,​·​so·​any21 unable·​to·​earn·​a·​living,​·​either·​by·​programming·​or·​by·​any·​other·​means,​·​so·​any
22 gifts·​will·​be·​much·​appreciated.​·​You·​can·​use·​the·​<a·​class="ulink"·​href="http:​/​/​sourceforge.​net/​donate/​index.​php?group_id=92322"·​target="_top">Sourcef​orge/​Paypal22 gifts·​will·​be·​much·​appreciated.​·​You·​can·​use·​the·​<a·​class="ulink"·​href="http:​/​/​sourceforge.​net/​donate/​index.​php?group_id=92322"·​target="_top">Sourcef​orge/​Paypal
23 donation·​scheme</​a>·​or·​<a·​class="link"·​href="ar01s12.​html"·​title="Contact·​details">see·​below</​a>·​to·​find23 donation·​scheme</​a>·​or·​<a·​class="link"·​href="ar01s12.​html"·​title="Contact·​details">see·​below</​a>·​to·​find
24 out·​where·​to·​send·​cheques·​or·​cash·​etc.​</​p><div·​class="sect2"·​title="Quick·​start·​guide"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63135928"></​a>Quick·​start·​guide</​h3></​div></​div></​div><p>A·​quick·​start·​guide·​is·​provided,​·​with·​brief·​instructions·​on·​how·​to24 out·​where·​to·​send·​cheques·​or·​cash·​etc.​</​p><div·​class="sect2"·​title="Quick·​start·​guide"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63615160"></​a>Quick·​start·​guide</​h3></​div></​div></​div><p>A·​quick·​start·​guide·​is·​provided,​·​with·​brief·​instructions·​on·​how·​to
25 configure·​newsstar·​once·​it·​is·​installed.​·​It·​starts·​off·​in·​the·​source25 configure·​newsstar·​once·​it·​is·​installed.​·​It·​starts·​off·​in·​the·​source
26 distribution·​as·​<code·​class="filename">docs​/​QuickStart.​in</​code>;​·​this·​is·​readable,​26 distribution·​as·​<code·​class="filename">docs​/​QuickStart.​in</​code>;​·​this·​is·​readable,​
27 but·​some·​directory·​names·​are·​abstracted,​·​enclosed·​in27 but·​some·​directory·​names·​are·​abstracted,​·​enclosed·​in
28 <code·​class="literal">@</​code>·​symbols.​·​After·​<span·​class="command"><stro​ng>configure</​strong></​span>·​has28 <code·​class="literal">@</​code>·​symbols.​·​After·​<span·​class="command"><stro​ng>configure</​strong></​span>·​has
29 been·​run,​·​<code·​class="filename">docs​/​QuickStart</​code>·​will·​be·​available,​·​containing29 been·​run,​·​<code·​class="filename">docs​/​QuickStart</​code>·​will·​be·​available,​·​containing
30 the·​actual·​directory·​names.​</​p><p>If·​you·​are·​installing·​from·​source,​·​and·​you·​want·​to·​use·​the·​quick·​start30 the·​actual·​directory·​names.​</​p><p>If·​you·​are·​installing·​from·​source,​·​and·​you·​want·​to·​use·​the·​quick·​start
31 guide,​·​read·​on·​to·​the·​<a·​class="link"·​href="ar01s06.​html"·​title="Building">buil​ding·​section</​a>,​·​follow·​the31 guide,​·​read·​on·​to·​the·​<a·​class="link"·​href="ar01s06.​html"·​title="Building">buil​ding·​section</​a>,​·​follow·​the
/usr/local/share/doc/newsstar/ar01s02.html
Offset 1, 4 lines modifiedOffset 1, 4 lines modified
1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>News</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="next"·​href="ar01s03.​html"·​title="Obtaining·​newsstar"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">News</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="index.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s03.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="News"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63153336"></​a>News</​h2></​div></​div></​div><p>See·​<a·​class="ulink"·​href="news.​ht·​✂1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>News</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="next"·​href="ar01s03.​html"·​title="Obtaining·​newsstar"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">News</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="index.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s03.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="News"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63636664"></​a>News</​h2></​div></​div></​div><p>See·​<a·​class="ulink"·​href="news.​ht·​✂
2 the·​project's·​<code·​class="filename">Chan​geLog</​code>·​file·​for·​more·​details.​</​p><p>News·​summaries·​for·​older·​versions·​are·​available·​in·​the·​file2 the·​project's·​<code·​class="filename">Chan​geLog</​code>·​file·​for·​more·​details.​</​p><p>News·​summaries·​for·​older·​versions·​are·​available·​in·​the·​file
3 <code·​class="filename">OLDN​EWS</​code>·​in·​the·​distribution's·​<code·​class="filename">docs​</​code>3 <code·​class="filename">OLDN​EWS</​code>·​in·​the·​distribution's·​<code·​class="filename">docs​</​code>
4 directory.​</​p></​div><div·​class="navfooter"><hr​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="index.​html">Prev</​a>&#160;​</​td><td·​width="20%"·​align="center">&#160;​</​td><td·​width="40%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s03.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Newsstar​&#160;​</​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top">&#160;​Obtaining·​newsstar</​td></​tr></​table></​div></​body></​html>4 directory.​</​p></​div><div·​class="navfooter"><hr​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="index.​html">Prev</​a>&#160;​</​td><td·​width="20%"·​align="center">&#160;​</​td><td·​width="40%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s03.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Newsstar​&#160;​</​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top">&#160;​Obtaining·​newsstar</​td></​tr></​table></​div></​body></​html>
/usr/local/share/doc/newsstar/ar01s03.html
Offset 1, 6 lines modifiedOffset 1, 6 lines modified
1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Obtaini​ng·​newsstar</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s02.​html"·​title="News"><link·​rel="next"·​href="ar01s04.​html"·​title="Requirements">​</​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Obtain​ing·​newsstar</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s02.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s04.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="Obtaining·​newsstar"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63161016"></​a>Obtaining·​newsstar</​h2></​div·​✂1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Obtaini​ng·​newsstar</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s02.​html"·​title="News"><link·​rel="next"·​href="ar01s04.​html"·​title="Requirements">​</​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Obtain​ing·​newsstar</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s02.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s04.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="Obtaining·​newsstar"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63640248"></​a>Obtaining·​newsstar</​h2></​div·​✂
2 at·​<a·​class="ulink"·​href="http:​/​/​newsstar.​sourceforge.​net"·​target="_top">http:​/​/​newsstar.​sourceforge.​net</​a>.​2 at·​<a·​class="ulink"·​href="http:​/​/​newsstar.​sourceforge.​net"·​target="_top">http:​/​/​newsstar.​sourceforge.​net</​a>.​
3 The·​Sourceforge·​project·​site,​·​where·​you·​can·​download·​newsstar,​·​report·​bugs3 The·​Sourceforge·​project·​site,​·​where·​you·​can·​download·​newsstar,​·​report·​bugs
4 and·​use·​the·​forums·​etc,​·​is·​at4 and·​use·​the·​forums·​etc,​·​is·​at
5 <a·​class="ulink"·​href="http:​/​/​sourceforge.​net/​projects/​newsstar/​"·​target="_top">http:​/​/​sourceforge.​net/​projects/​newsstar/​</​a>.​</​p><p>A·​Debian·​package·​is·​also·​available·​from·​the·​project's·​<a·​class="ulink"·​href="http:​/​/​sourceforge.​net/​project/​showfiles.​php?group_id=92322"·​target="_top">Sourcef​orge5 <a·​class="ulink"·​href="http:​/​/​sourceforge.​net/​projects/​newsstar/​"·​target="_top">http:​/​/​sourceforge.​net/​projects/​newsstar/​</​a>.​</​p><p>A·​Debian·​package·​is·​also·​available·​from·​the·​project's·​<a·​class="ulink"·​href="http:​/​/​sourceforge.​net/​project/​showfiles.​php?group_id=92322"·​target="_top">Sourcef​orge
6 file·​list</​a>.​</​p></​div><div·​class="navfooter"><hr​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ar01s02.​html">Prev</​a>&#160;​</​td><td·​width="20%"·​align="center">&#160;​</​td><td·​width="40%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s04.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">News&#16​0;​</​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top">&#160;​Requirements</​td></​tr></​table></​div></​body></​html>6 file·​list</​a>.​</​p></​div><div·​class="navfooter"><hr​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ar01s02.​html">Prev</​a>&#160;​</​td><td·​width="20%"·​align="center">&#160;​</​td><td·​width="40%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s04.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">News&#16​0;​</​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top">&#160;​Requirements</​td></​tr></​table></​div></​body></​html>
/usr/local/share/doc/newsstar/ar01s04.html
Offset 1, 8 lines modifiedOffset 1, 8 lines modified
1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Require​ments</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s03.​html"·​title="Obtaining·​newsstar"><link·​rel="next"·​href="ar01s05.​html"·​title="Directories·​used"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Requir​ements</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s03.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s05.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="Requirements">​<div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63164088"></​a>Requirements</​h2></​div></​div·​✂1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Require​ments</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s03.​html"·​title="Obtaining·​newsstar"><link·​rel="next"·​href="ar01s05.​html"·​title="Directories·​used"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Requir​ements</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s03.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s05.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="Requirements">​<div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63643320"></​a>Requirements</​h2></​div></​div·​✂
2 <em·​class="firstterm">Lin​ux</​em>,​·​to·​run·​and·​compile·​newsstar.​··​The2 <em·​class="firstterm">Lin​ux</​em>,​·​to·​run·​and·​compile·​newsstar.​··​The
3 <code·​class="systemitem">cu​rses</​code>·​library·​(preferably·​<code·​class="systemitem">GN​U3 <code·​class="systemitem">cu​rses</​code>·​library·​(preferably·​<code·​class="systemitem">GN​U
4 ncurses</​code>)​·​gives·​extra·​functionality,​·​but·​isn't·​essential.​··​The4 ncurses</​code>)​·​gives·​extra·​functionality,​·​but·​isn't·​essential.​··​The
5 <code·​class="systemitem">gd​bm</​code>·​library·​and·​headers·​are·​needed·​if·​newsstar·​is·​to5 <code·​class="systemitem">gd​bm</​code>·​library·​and·​headers·​are·​needed·​if·​newsstar·​is·​to
6 maintain·​its·​own·​history·​database.​</​p><p>Obviously·​you'll·​need·​the·​details·​of·​at·​least·​one·​news·​server·​to·​download6 maintain·​its·​own·​history·​database.​</​p><p>Obviously·​you'll·​need·​the·​details·​of·​at·​least·​one·​news·​server·​to·​download
7 news·​from.​·​The·​easiest·​way·​to·​feed·​articles·​to·​most·​servers·​is·​via·​an·​rnews7 news·​from.​·​The·​easiest·​way·​to·​feed·​articles·​to·​most·​servers·​is·​via·​an·​rnews
8 batch,​·​but·​direct·​injection·​via·​NNTP·​is·​supported·​for·​INN·​and·​s-​news.​·​The8 batch,​·​but·​direct·​injection·​via·​NNTP·​is·​supported·​for·​INN·​and·​s-​news.​·​The
/usr/local/share/doc/newsstar/ar01s05.html
Offset 1, 2 lines modifiedOffset 1, 2 lines modified
1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Directo​ries·​used</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s04.​html"·​title="Requirements">​<link·​rel="next"·​href="ar01s06.​html"·​title="Building"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Direct​ories·​used</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s04.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s06.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="Directories·​used"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63169848"></​a>Directories·​used</​h2></​div></​d·​✂1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Directo​ries·​used</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s04.​html"·​title="Requirements">​<link·​rel="next"·​href="ar01s06.​html"·​title="Building"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Direct​ories·​used</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s04.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s06.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="Directories·​used"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63649080"></​a>Directories·​used</​h2></​div></​d·​✂
2 final·​locations·​can·​not·​be·​shown·​in·​this·​file.​·​Here·​is·​a·​summary:​</​p><div·​class="informaltable"​><table·​border="1"><colgroup>​<col><col><col></​colgroup><thead><tr><​th>Abstract·​name</​th><th>Typical·​location</​th><th>Description</​th></​tr></​thead><tbody><tr><td>​<code·​class="constant">CONF​_DIR</​code></​td><td><code·​class="filename">/​etc/​newsstar</​code></​td><td>Holds·​main·​configuration·​files</​td></​tr><tr><td><code·​class="varname">RC_DI​R</​code></​td><td><code·​class="filename">/​var/​lib/​newsstar</​code></​td><td>Writable·​data·​files,​·​especially·​newsrc·​files</​td></​tr><tr><td><code·​class="varname">INCOM​ING_DIR</​code></​td><td><code·​class="filename">/​var/​spool/​newsstar-​incoming</​code></​td><td>Temporary·​holding·​place·​for·​downloaded·​articles</​td></​tr><tr><td><code·​class="varname">SPOOL​_DIR</​code></​td><td><code·​class="filename">/​var/​spool/​news</​code></​td><td>Local·​news·​server's·​spool·​directory</​td></​tr><tr><td><code·​class="varname">OUTGO​ING_DIR</​code></​td><td><code·​class="filename">/​var/​spool/​news/​outgoing</​code></​td><td>Where·​loca·​✂2 final·​locations·​can·​not·​be·​shown·​in·​this·​file.​·​Here·​is·​a·​summary:​</​p><div·​class="informaltable"​><table·​border="1"><colgroup>​<col><col><col></​colgroup><thead><tr><​th>Abstract·​name</​th><th>Typical·​location</​th><th>Description</​th></​tr></​thead><tbody><tr><td>​<code·​class="constant">CONF​_DIR</​code></​td><td><code·​class="filename">/​etc/​newsstar</​code></​td><td>Holds·​main·​configuration·​files</​td></​tr><tr><td><code·​class="varname">RC_DI​R</​code></​td><td><code·​class="filename">/​var/​lib/​newsstar</​code></​td><td>Writable·​data·​files,​·​especially·​newsrc·​files</​td></​tr><tr><td><code·​class="varname">INCOM​ING_DIR</​code></​td><td><code·​class="filename">/​var/​spool/​newsstar-​incoming</​code></​td><td>Temporary·​holding·​place·​for·​downloaded·​articles</​td></​tr><tr><td><code·​class="varname">SPOOL​_DIR</​code></​td><td><code·​class="filename">/​var/​spool/​news</​code></​td><td>Local·​news·​server's·​spool·​directory</​td></​tr><tr><td><code·​class="varname">OUTGO​ING_DIR</​code></​td><td><code·​class="filename">/​var/​spool/​news/​outgoing</​code></​td><td>Where·​loca·​✂
/usr/local/share/doc/newsstar/ar01s07.html
Offset 1, 8 lines modifiedOffset 1, 8 lines modified
1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Setting​·​up</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s06.​html"·​title="Building"><lin​k·​rel="next"·​href="ar01s08.​html"·​title="How·​it·​works"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Settin​g·​up</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s06.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s08.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="Setting·​up"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63206456"></​a>Setting·​up</​h2></​div></​div></​div><p>Newsstar·​ins·​✂1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Setting​·​up</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s06.​html"·​title="Building"><lin​k·​rel="next"·​href="ar01s08.​html"·​title="How·​it·​works"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Settin​g·​up</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s06.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s08.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="Setting·​up"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63685688"></​a>Setting·​up</​h2></​div></​div></​div><p>Newsstar·​ins·​✂
2 the·​configured·​<code·​class="filename">libe​xec</​code>·​directory,​·​which·​isn't·​intended2 the·​configured·​<code·​class="filename">libe​xec</​code>·​directory,​·​which·​isn't·​intended
3 to·​be·​run·​independently.​·​Instead,​·​you·​should·​always·​call·​the·​perl·​script,​3 to·​be·​run·​independently.​·​Instead,​·​you·​should·​always·​call·​the·​perl·​script,​
4 also·​called·​<code·​class="filename">news​star</​code>,​·​which·​acts·​as·​a·​front-​end·​and4 also·​called·​<code·​class="filename">news​star</​code>,​·​which·​acts·​as·​a·​front-​end·​and
5 performs·​a·​lot·​of·​support·​work·​for·​the·​binary.​·​Prior·​to·​version5 performs·​a·​lot·​of·​support·​work·​for·​the·​binary.​·​Prior·​to·​version
6 <span·​class="productnumber"​>0.​11.​0</​span>,​·​the·​script·​was·​called6 <span·​class="productnumber"​>0.​11.​0</​span>,​·​the·​script·​was·​called
7 <code·​class="filename">news​star.​pl</​code>.​·​A·​symbolic·​link·​used·​to·​be·​installed·​for7 <code·​class="filename">news​star.​pl</​code>.​·​A·​symbolic·​link·​used·​to·​be·​installed·​for
8 backwards·​compatibility,​·​but·​the·​name·​<code·​class="filename">news​star.​pl</​code>·​was8 backwards·​compatibility,​·​but·​the·​name·​<code·​class="filename">news​star.​pl</​code>·​was
Offset 18, 15 lines modifiedOffset 18, 15 lines modified
18 (<code·​class="literal">"</​code>)​.​·​Lines·​beginning·​with·​<code·​class="literal">#</​code>·​are18 (<code·​class="literal">"</​code>)​.​·​Lines·​beginning·​with·​<code·​class="literal">#</​code>·​are
19 comments,​·​and·​blank·​lines·​are·​also·​ignored.​·​A·​sample·​file·​called19 comments,​·​and·​blank·​lines·​are·​also·​ignored.​·​A·​sample·​file·​called
20 <code·​class="filename">main​.​cf.​sample</​code>·​is·​provided·​in·​the20 <code·​class="filename">main​.​cf.​sample</​code>·​is·​provided·​in·​the
21 <code·​class="filename">samp​le_config</​code><sup>[<a·​name="fn_sample_confi​g"·​href="#ftn.​fn_sample_config"·​class="footnote">1</​a>]</​sup>·​directory,​·​which·​you21 <code·​class="filename">samp​le_config</​code><sup>[<a·​name="fn_sample_confi​g"·​href="#ftn.​fn_sample_config"·​class="footnote">1</​a>]</​sup>·​directory,​·​which·​you
22 should·​copy·​to·​use·​as·​the·​basis·​for·​your·​own·​file.​·​Each·​option·​is·​documented22 should·​copy·​to·​use·​as·​the·​basis·​for·​your·​own·​file.​·​Each·​option·​is·​documented
23 there,​·​with·​the·​default·​value·​for·​each·​option·​shown.​·​Commented·​options·​have23 there,​·​with·​the·​default·​value·​for·​each·​option·​shown.​·​Commented·​options·​have
24 no·​default·​value.​</​p><p>A·​main.​cf·​file·​is·​not·​compulsory.​</​p><p><a·​class="link"·​href="ar01s07.​html#servercf"·​title="Server-​specific·​config·​files">See·​also·​server-​specific·​option24 no·​default·​value.​</​p><p>A·​main.​cf·​file·​is·​not·​compulsory.​</​p><p><a·​class="link"·​href="ar01s07.​html#servercf"·​title="Server-​specific·​config·​files">See·​also·​server-​specific·​option
25 files.​</​a></​p></​div><div·​class="sect2"·​title="Setting·​up·​for·​download"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63234232"></​a>Setting·​up·​for·​download</​h3></​div></​div></​div><div·​class="sect3"·​title="newsrc·​files"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​name="rcstar"></​a>newsrc·​files</​h4></​div></​div></​div><p>Once·​newsstar·​has·​read·​its·​<code·​class="filename">main​.​cf</​code>·​file·​it·​scans·​the25 files.​</​a></​p></​div><div·​class="sect2"·​title="Setting·​up·​for·​download"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63713464"></​a>Setting·​up·​for·​download</​h3></​div></​div></​div><div·​class="sect3"·​title="newsrc·​files"><div·​class="titlepage"><di​v><div><h4·​class="title"><a·​name="rcstar"></​a>newsrc·​files</​h4></​div></​div></​div><p>Once·​newsstar·​has·​read·​its·​<code·​class="filename">main​.​cf</​code>·​file·​it·​scans·​the
26 newsrc·​directory·​(<code·​class="filename">RC_D​IR</​code>)​·​for·​one·​or·​more·​files·​named26 newsrc·​directory·​(<code·​class="filename">RC_D​IR</​code>)​·​for·​one·​or·​more·​files·​named
27 <code·​class="filename">news​rc.​<em·​class="replaceable"><​code>*</​code></​em></​code>,​·​where·​the27 <code·​class="filename">news​rc.​<em·​class="replaceable"><​code>*</​code></​em></​code>,​·​where·​the
28 <em·​class="replaceable"><​code>*</​code></​em>·​is·​the·​name·​of·​each·​server.​·​This·​name·​can·​either28 <em·​class="replaceable"><​code>*</​code></​em>·​is·​the·​name·​of·​each·​server.​·​This·​name·​can·​either
29 be·​its·​address,​·​or·​a·​nickname,​·​in·​which·​case·​you·​must·​provide·​its·​address·​in29 be·​its·​address,​·​or·​a·​nickname,​·​in·​which·​case·​you·​must·​provide·​its·​address·​in
30 its·​config·​file·​(<a·​class="link"·​href="ar01s07.​html#servercf"·​title="Server-​specific·​config·​files">see·​below</​a>)​.​</​p><p>Each·​<code·​class="systemitem">ne​wsrc·​file</​code>·​contains·​one30 its·​config·​file·​(<a·​class="link"·​href="ar01s07.​html#servercf"·​title="Server-​specific·​config·​files">see·​below</​a>)​.​</​p><p>Each·​<code·​class="systemitem">ne​wsrc·​file</​code>·​contains·​one
31 <code·​class="systemitem">ne​wsgroup</​code>·​entry·​per·​line:​·​the·​name·​of·​each·​newsgroup,​31 <code·​class="systemitem">ne​wsgroup</​code>·​entry·​per·​line:​·​the·​name·​of·​each·​newsgroup,​
32 optionally·​separated·​from·​a·​number·​by·​whitespace.​·​If·​there·​is·​no·​number,​32 optionally·​separated·​from·​a·​number·​by·​whitespace.​·​If·​there·​is·​no·​number,​
Offset 83, 15 lines modifiedOffset 83, 15 lines modified
83 specific·​groups·​or·​hierarchies,​·​followed·​by·​more·​general·​patterns·​to83 specific·​groups·​or·​hierarchies,​·​followed·​by·​more·​general·​patterns·​to
84 exclude.​·​For·​example,​·​say·​you·​connected·​to·​a·​specialist·​news·​server·​carrying84 exclude.​·​For·​example,​·​say·​you·​connected·​to·​a·​specialist·​news·​server·​carrying
85 groups·​in·​the·​<code·​class="systemitem">lo​ki.​*</​code>·​hierarchy.​·​You·​could·​use·​the85 groups·​in·​the·​<code·​class="systemitem">lo​ki.​*</​code>·​hierarchy.​·​You·​could·​use·​the
86 following·​ignore·​file·​to·​make·​it·​fetch·​all·​loki·​groups·​found·​in·​your·​active86 following·​ignore·​file·​to·​make·​it·​fetch·​all·​loki·​groups·​found·​in·​your·​active
87 file,​·​and·​ignore·​all·​others:​</​p><pre·​class="screen">87 file,​·​and·​ignore·​all·​others:​</​p><pre·​class="screen">
88 !loki\.​88 !loki\.​
89 .​*89 .​*
90 </​pre></​div></​div><div·​class="sect2"·​title="Setting·​up·​for·​upload"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63292984"></​a>Setting·​up·​for·​upload</​h3></​div></​div></​div><p>For·​each·​server·​with·​an·​outgoing·​feed·​enabled,​·​newsstar·​looks·​for·​a90 </​pre></​div></​div><div·​class="sect2"·​title="Setting·​up·​for·​upload"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63743544"></​a>Setting·​up·​for·​upload</​h3></​div></​div></​div><p>For·​each·​server·​with·​an·​outgoing·​feed·​enabled,​·​newsstar·​looks·​for·​a
91 subdirectory·​named·​after·​the·​server·​in·​its·​outgoing·​directory·​eg91 subdirectory·​named·​after·​the·​server·​in·​its·​outgoing·​directory·​eg
92 <code·​class="filename"><em·​class="replaceable"><​code>OUTGOING_DIR</​code></​em>/​newsstar/​my.​news.​server</​code>92 <code·​class="filename"><em·​class="replaceable"><​code>OUTGOING_DIR</​code></​em>/​newsstar/​my.​news.​server</​code>
93 where·​<em·​class="replaceable"><​code>OUTGOING_DIR</​code></​em>·​is·​usually93 where·​<em·​class="replaceable"><​code>OUTGOING_DIR</​code></​em>·​is·​usually
94 <code·​class="filename">/​var/​spool/​news/​outgoing</​code>.​··​It·​reads·​article·​files·​from94 <code·​class="filename">/​var/​spool/​news/​outgoing</​code>.​··​It·​reads·​article·​files·​from
95 the·​directory·​and·​tries·​to·​upload·​each·​one·​to·​the·​remote·​server.​</​p><p>From·​newsstar·​1.​3.​0·​onwards·​you·​can·​use·​the·​<code·​class="option">extra_​feed</​code>95 the·​directory·​and·​tries·​to·​upload·​each·​one·​to·​the·​remote·​server.​</​p><p>From·​newsstar·​1.​3.​0·​onwards·​you·​can·​use·​the·​<code·​class="option">extra_​feed</​code>
96 directive·​in·​the·​<a·​class="link"·​href="ar01s07.​html#servercf"·​title="Server-​specific·​config·​files">server's·​config·​file</​a>·​to96 directive·​in·​the·​<a·​class="link"·​href="ar01s07.​html#servercf"·​title="Server-​specific·​config·​files">server's·​config·​file</​a>·​to
97 make·​it·​use·​a·​named·​feed·​as·​well·​as·​or·​instead·​of·​the·​feed·​named·​after·​the97 make·​it·​use·​a·​named·​feed·​as·​well·​as·​or·​instead·​of·​the·​feed·​named·​after·​the
Offset 120, 15 lines modifiedOffset 120, 15 lines modified
120 filtering.​··​Each·​time·​an·​article·​is·​about·​to·​be·​uploaded,​·​the·​function·​will120 filtering.​··​Each·​time·​an·​article·​is·​about·​to·​be·​uploaded,​·​the·​function·​will
121 be·​called·​with·​two·​arguments.​·​The·​first·​is·​a·​reference·​to·​an·​array,​·​each121 be·​called·​with·​two·​arguments.​·​The·​first·​is·​a·​reference·​to·​an·​array,​·​each
122 element·​containing·​one·​line·​(including·​terminator)​·​of·​the·​message.​·​The122 element·​containing·​one·​line·​(including·​terminator)​·​of·​the·​message.​·​The
123 second·​is·​the·​name·​of·​the·​server.​</​p><p>The·​recommended·​way·​to·​delete·​a·​header·​is·​to·​replace·​it·​with·​a·​null123 second·​is·​the·​name·​of·​the·​server.​</​p><p>The·​recommended·​way·​to·​delete·​a·​header·​is·​to·​replace·​it·​with·​a·​null
124 string,​·​without·​a·​line·​terminator.​·​To·​prevent·​a·​message·​being·​uploaded·​at124 string,​·​without·​a·​line·​terminator.​·​To·​prevent·​a·​message·​being·​uploaded·​at
125 all,​·​replace·​every·​line·​with·​blanks.​</​p><p>A·​sample·​script·​is·​provided.​·​If·​you·​do·​not·​provide·​a·​script,​125 all,​·​replace·​every·​line·​with·​blanks.​</​p><p>A·​sample·​script·​is·​provided.​·​If·​you·​do·​not·​provide·​a·​script,​
126 newsstar's·​own·​perl·​script·​has·​a·​built-​in·​function·​which·​removes·​the·​same126 newsstar's·​own·​perl·​script·​has·​a·​built-​in·​function·​which·​removes·​the·​same
127 headers·​as·​the·​sample.​</​p></​div></​div><div·​class="sect2"·​title="Command-​line·​options"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63307064"></​a>Command-​line·​options</​h3></​div></​div></​div><p>Some·​of·​the·​options·​below·​are·​used·​only·​by127 headers·​as·​the·​sample.​</​p></​div></​div><div·​class="sect2"·​title="Command-​line·​options"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63753528"></​a>Command-​line·​options</​h3></​div></​div></​div><p>Some·​of·​the·​options·​below·​are·​used·​only·​by
128 <code·​class="filename">news​star.​bin</​code>·​<sup>[<a·​name="binonly"·​href="#ftn.​binonly"·​class="footnote">2</​a>]</​sup>·​(the·​script·​recognises·​them·​and·​passes·​them128 <code·​class="filename">news​star.​bin</​code>·​<sup>[<a·​name="binonly"·​href="#ftn.​binonly"·​class="footnote">2</​a>]</​sup>·​(the·​script·​recognises·​them·​and·​passes·​them
129 on)​,​·​some·​only·​by·​the·​perl·​script·​<sup>[<a·​name="scronly"·​href="#ftn.​scronly"·​class="footnote">3</​a>]</​sup>,​·​and·​some·​by·​both129 on)​,​·​some·​only·​by·​the·​perl·​script·​<sup>[<a·​name="scronly"·​href="#ftn.​scronly"·​class="footnote">3</​a>]</​sup>,​·​and·​some·​by·​both
130 <sup>[<a·​name="binandscr"·​href="#ftn.​binandscr"·​class="footnote">4</​a>]</​sup>.​130 <sup>[<a·​name="binandscr"·​href="#ftn.​binandscr"·​class="footnote">4</​a>]</​sup>.​
131 Most·​users·​can·​ignore·​which·​is·​which,​·​but·​the·​information·​is·​provided·​for131 Most·​users·​can·​ignore·​which·​is·​which,​·​but·​the·​information·​is·​provided·​for
132 advanced·​tinkerers.​</​p><div·​class="variablelist">​<dl><dt><span·​class="term">Select·​local·​server·​type·​<sup>[<a·​href="ar01s07.​html#ftn.​binandscr"·​class="footnoteref">4​</​a>]</​sup>,​·​</​span><span·​class="term"><code·​class="option">-​sn</​code>,​·​</​span><span·​class="term"><code·​class="option">-​snews</​code></​span></​dt><dd><p>Use·​the·​<code·​class="option">-​sn</​code>·​option·​if·​your·​local·​server·​is·​sn132 advanced·​tinkerers.​</​p><div·​class="variablelist">​<dl><dt><span·​class="term">Select·​local·​server·​type·​<sup>[<a·​href="ar01s07.​html#ftn.​binandscr"·​class="footnoteref">4​</​a>]</​sup>,​·​</​span><span·​class="term"><code·​class="option">-​sn</​code>,​·​</​span><span·​class="term"><code·​class="option">-​snews</​code></​span></​dt><dd><p>Use·​the·​<code·​class="option">-​sn</​code>·​option·​if·​your·​local·​server·​is·​sn
133 ······​or·​the·​<code·​class="option">-​snews</​code>·​option·​for·​snews.​·​If·​neither·​option·​is133 ······​or·​the·​<code·​class="option">-​snews</​code>·​option·​for·​snews.​·​If·​neither·​option·​is
134 ······​given,​·​the·​server·​is·​assumed·​to·​be·​INN.​</​p></​dd><dt><span·​class="term">Location​·​of·​important·​news·​server·​executables134 ······​given,​·​the·​server·​is·​assumed·​to·​be·​INN.​</​p></​dd><dt><span·​class="term">Location​·​of·​important·​news·​server·​executables
Offset 241, 15 lines modifiedOffset 241, 15 lines modified
241 »       ​»       ​<code·​class="option">-​w<em·​class="replaceable"><​code>/​usr/​bin/​valgrind</​code></​em></​code>.​·​Note241 »       ​»       ​<code·​class="option">-​w<em·​class="replaceable"><​code>/​usr/​bin/​valgrind</​code></​em></​code>.​·​Note
242 »       ​»       ​there·​is·​no·​space·​between·​<code·​class="option">-​w</​code>·​and242 »       ​»       ​there·​is·​no·​space·​between·​<code·​class="option">-​w</​code>·​and
243 »       ​»       ​<code·​class="option"><em·​class="replaceable"><​code>WRAPPER</​code></​em></​code>.​</​p></​dd><dt><span·​class="term">Debuggin​g·​without·​running·​the·​binary243 »       ​»       ​<code·​class="option"><em·​class="replaceable"><​code>WRAPPER</​code></​em></​code>.​</​p></​dd><dt><span·​class="term">Debuggin​g·​without·​running·​the·​binary
244 ······​<sup>[<a·​href="ar01s07.​html#ftn.​scronly"·​class="footnoteref">3​</​a>]</​sup>244 ······​<sup>[<a·​href="ar01s07.​html#ftn.​scronly"·​class="footnoteref">3​</​a>]</​sup>
245 ····​,​·​</​span><span·​class="term"><code·​class="option">-​-​preprocess</​code>,​·​</​span><span·​class="term"><code·​class="option">-​-​postprocess</​code></​span></​dt><dd><p>As·​an·​aid·​to·​debugging,​·​the·​<code·​class="option">-​-​preprocess</​code>·​and245 ····​,​·​</​span><span·​class="term"><code·​class="option">-​-​preprocess</​code>,​·​</​span><span·​class="term"><code·​class="option">-​-​postprocess</​code></​span></​dt><dd><p>As·​an·​aid·​to·​debugging,​·​the·​<code·​class="option">-​-​preprocess</​code>·​and
246 ······​<code·​class="option">-​-​postprocess</​code>·​options·​instruct·​the·​perl·​script·​just246 ······​<code·​class="option">-​-​postprocess</​code>·​options·​instruct·​the·​perl·​script·​just
247 ······​to·​perform·​its·​functions·​prior·​to·​or·​after·​running·​the·​binary247 ······​to·​perform·​its·​functions·​prior·​to·​or·​after·​running·​the·​binary
248 ······​respectively,​·​without·​actually·​running·​the·​binary.​</​p></​dd></​dl></​div></​div><div·​class="sect2"·​title="Upgrading·​from·​versions·​earlier·​than·​0.​7.​0"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63395896"></​a>Upgrading·​from·​versions·​earlier·​than248 ······​respectively,​·​without·​actually·​running·​the·​binary.​</​p></​dd></​dl></​div></​div><div·​class="sect2"·​title="Upgrading·​from·​versions·​earlier·​than·​0.​7.​0"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63842360"></​a>Upgrading·​from·​versions·​earlier·​than
249 <span·​class="productnumber"​>0.​7.​0</​span></​h3></​div></​div></​div><p>As·​<em·​class="replaceable"><​code>SPOOL_DIR</​code></​em>·​is·​dependent·​on·​the·​news249 <span·​class="productnumber"​>0.​7.​0</​span></​h3></​div></​div></​div><p>As·​<em·​class="replaceable"><​code>SPOOL_DIR</​code></​em>·​is·​dependent·​on·​the·​news
250 server,​·​rather·​than·​owned·​by·​newsstar,​·​newsstar's250 server,​·​rather·​than·​owned·​by·​newsstar,​·​newsstar's
251 <em·​class="replaceable"><​code>RC_DIR</​code></​em>·​is·​now·​separate.​251 <em·​class="replaceable"><​code>RC_DIR</​code></​em>·​is·​now·​separate.​
252 <em·​class="replaceable"><​code>SPOOL_DIR</​code></​em>·​and·​other·​directories/​files·​owned·​by252 <em·​class="replaceable"><​code>SPOOL_DIR</​code></​em>·​and·​other·​directories/​files·​owned·​by
253 the·​news·​server·​are·​now·​configurable·​in·​<code·​class="filename">main​.​cf</​code>,​·​to253 the·​news·​server·​are·​now·​configurable·​in·​<code·​class="filename">main​.​cf</​code>,​·​to
254 prevent·​the·​need·​for·​separately·​compiled·​versions·​of·​newsstar·​to·​work·​with254 prevent·​the·​need·​for·​separately·​compiled·​versions·​of·​newsstar·​to·​work·​with
255 the·​different·​types·​of·​server.​</​p><p>If·​upgrading·​from·​an·​earlier·​version,​·​you·​should·​use·​a·​directory·​such255 the·​different·​types·​of·​server.​</​p><p>If·​upgrading·​from·​an·​earlier·​version,​·​you·​should·​use·​a·​directory·​such
/usr/local/share/doc/newsstar/ar01s08.html
Offset 1, 15 lines modifiedOffset 1, 15 lines modified
1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>How·​it·​works</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s07.​html"·​title="Setting·​up"><link·​rel="next"·​href="ar01s09.​html"·​title="Migrating·​from·​suck"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">How·​it·​works</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s07.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s09.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="How·​it·​works"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63403320"></​a>How·​it·​works</​h2></​div></​div></​di·​✂1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>How·​it·​works</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s07.​html"·​title="Setting·​up"><link·​rel="next"·​href="ar01s09.​html"·​title="Migrating·​from·​suck"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">How·​it·​works</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s07.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s09.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="How·​it·​works"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="idp63849784"></​a>How·​it·​works</​h2></​div></​div></​di·​✂
2 functions:​</​p><div·​class="sect2"·​title="Preparing·​articles·​for·​upload"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63404856"></​a>Preparing·​articles·​for·​upload</​h3></​div></​div></​div><p>For·​each·​newsrc·​file,​·​the·​script·​looks·​for·​a·​corresponding·​newsfeeds·​file2 functions:​</​p><div·​class="sect2"·​title="Preparing·​articles·​for·​upload"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63851320"></​a>Preparing·​articles·​for·​upload</​h3></​div></​div></​div><p>For·​each·​newsrc·​file,​·​the·​script·​looks·​for·​a·​corresponding·​newsfeeds·​file
3 (for·​INN·​or·​s-​news)​·​or·​outgoing·​directory·​(for·​sn)​·​in3 (for·​INN·​or·​s-​news)​·​or·​outgoing·​directory·​(for·​sn)​·​in
4 <em·​class="replaceable"><​code>OUTGOING_DIR</​code></​em>.​</​p><p>Newsfeeds·​files·​are·​flushed,​·​and·​the·​referenced·​articles·​copied·​into4 <em·​class="replaceable"><​code>OUTGOING_DIR</​code></​em>.​</​p><p>Newsfeeds·​files·​are·​flushed,​·​and·​the·​referenced·​articles·​copied·​into
5 the·​appropriate·​directory·​for·​the·​newsstar·​binary,​·​with·​the·​<a·​class="link"·​href="ar01s07.​html#filter"·​title="Filtering·​uploaded·​articles">upload·​filter</​a>·​applied.​·​The·​feed·​file,​·​usually5 the·​appropriate·​directory·​for·​the·​newsstar·​binary,​·​with·​the·​<a·​class="link"·​href="ar01s07.​html#filter"·​title="Filtering·​uploaded·​articles">upload·​filter</​a>·​applied.​·​The·​feed·​file,​·​usually
6 generated·​by·​INN,​·​contains·​one·​article·​reference·​per·​line.​·​Newsstar·​is·​only6 generated·​by·​INN,​·​contains·​one·​article·​reference·​per·​line.​·​Newsstar·​is·​only
7 interested·​in·​the·​first·​field·​in·​each·​line,​·​which·​can·​either·​be·​a·​partial7 interested·​in·​the·​first·​field·​in·​each·​line,​·​which·​can·​either·​be·​a·​partial
8 path·​to·​the·​article,​·​or·​a·​storage·​token.​··​The·​script·​automatically8 path·​to·​the·​article,​·​or·​a·​storage·​token.​··​The·​script·​automatically
9 distinguishes·​between·​partial·​paths·​and·​tokens,​·​taking·​appropriate·​action·​to9 distinguishes·​between·​partial·​paths·​and·​tokens,​·​taking·​appropriate·​action·​to
10 locate·​the·​referenced·​file.​</​p><p>For·​sn,​·​the·​processs·​is·​slightly·​simpler:​·​the·​files·​just·​have·​to·​be10 locate·​the·​referenced·​file.​</​p><p>For·​sn,​·​the·​processs·​is·​slightly·​simpler:​·​the·​files·​just·​have·​to·​be
11 moved,​·​processed·​from·​sn's·​<code·​class="systemitem">"w​ire·​format"</​code>·​into·​plain11 moved,​·​processed·​from·​sn's·​<code·​class="systemitem">"w​ire·​format"</​code>·​into·​plain
12 text,​·​and·​the·​<a·​class="link"·​href="ar01s07.​html#filter"·​title="Filtering·​uploaded·​articles">upload·​filter</​a>·​applied.​</​p></​div><div·​class="sect2"·​title="Running·​the·​binary,​·​processing·​downloaded·​articles,​·​clearing·​up"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63408696"></​a>Running·​the·​binary,​·​processing·​downloaded·​articles,​·​clearing12 text,​·​and·​the·​<a·​class="link"·​href="ar01s07.​html#filter"·​title="Filtering·​uploaded·​articles">upload·​filter</​a>·​applied.​</​p></​div><div·​class="sect2"·​title="Running·​the·​binary,​·​processing·​downloaded·​articles,​·​clearing·​up"><div·​class="titlepage"><di​v><div><h3·​class="title"><a·​name="idp63855160"></​a>Running·​the·​binary,​·​processing·​downloaded·​articles,​·​clearing
13 up</​h3></​div></​div></​div><p>Finally,​·​the·​script·​runs·​the·​binary,​·​posts·​the·​downloaded·​batch·​(if13 up</​h3></​div></​div></​div><p>Finally,​·​the·​script·​runs·​the·​binary,​·​posts·​the·​downloaded·​batch·​(if
14 present)​·​to·​the·​local·​server,​·​mails·​failed·​postings·​back·​to·​their·​sender·​and14 present)​·​to·​the·​local·​server,​·​mails·​failed·​postings·​back·​to·​their·​sender·​and
15 deletes·​them,​·​removes·​any·​remaining·​temporary·​files·​etc,​·​and·​exits.​</​p></​div></​div><div·​class="navfooter"><hr​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ar01s07.​html">Prev</​a>&#160;​</​td><td·​width="20%"·​align="center">&#160;​</​td><td·​width="40%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s09.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Setting·​up&#160;​</​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top">&#160;​Migrating·​from·​suck</​td></​tr></​table></​div></​body></​html>15 deletes·​them,​·​removes·​any·​remaining·​temporary·​files·​etc,​·​and·​exits.​</​p></​div></​div><div·​class="navfooter"><hr​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ar01s07.​html">Prev</​a>&#160;​</​td><td·​width="20%"·​align="center">&#160;​</​td><td·​width="40%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s09.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Setting·​up&#160;​</​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top">&#160;​Migrating·​from·​suck</​td></​tr></​table></​div></​body></​html>
/usr/local/share/doc/newsstar/ar01s11.html
Offset 1, 7 lines modifiedOffset 1, 7 lines modified
1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Interru​pting·​while·​running</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s10.​html"·​title="Score-​based·​killfiling"><link·​rel="next"·​href="ar01s12.​html"·​title="Contact·​details"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Interr​upting·​while·​running</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s10.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s12.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="Interrupting·​while·​running"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="·​✂1 <html><head><meta·​http-​equiv="Content-​Type"·​content="text/​html;​·​charset=US-​ASCII"><title>Interru​pting·​while·​running</​title><meta·​name="generator"·​content="DocBook·​XSL·​Stylesheets·​V1.​76.​1"><link·​rel="home"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="up"·​href="index.​html"·​title="Newsstar"><lin​k·​rel="prev"·​href="ar01s10.​html"·​title="Score-​based·​killfiling"><link·​rel="next"·​href="ar01s12.​html"·​title="Contact·​details"></​head><body·​bgcolor="white"·​text="black"·​link="#0000FF"·​vlink="#840084"·​alink="#0000FF"><div·​class="navheader"><ta​ble·​width="100%"·​summary="Navigation·​header"><tr><th·​colspan="3"·​align="center">Interr​upting·​while·​running</​th></​tr><tr><td·​width="20%"·​align="left"><a·​accesskey="p"·​href="ar01s10.​html">Prev</​a>&#160;​</​td><th·​width="60%"·​align="center">&#160;​</​th><td·​width="20%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s12.​html">Next</​a></​td></​tr></​table><hr></​div><div·​class="sect1"·​title="Interrupting·​while·​running"><div·​class="titlepage"><di​v><div><h2·​class="title"·​style="clear:​·​both"><a·​name="·​✂
2 usually·​by·​pressing·​Ctrl-​C·​in·​the·​terminal·​it's·​running·​on,​·​it·​will·​not·​exit2 usually·​by·​pressing·​Ctrl-​C·​in·​the·​terminal·​it's·​running·​on,​·​it·​will·​not·​exit
3 straight·​away,​·​but·​first·​wait·​until·​it's·​received·​all·​articles·​it's3 straight·​away,​·​but·​first·​wait·​until·​it's·​received·​all·​articles·​it's
4 requested·​which·​are·​held·​in·​the·​"pipeline"·​etc·​and·​log·​off·​cleanly·​from·​all4 requested·​which·​are·​held·​in·​the·​"pipeline"·​etc·​and·​log·​off·​cleanly·​from·​all
5 servers.​</​p><p>If·​it·​receives·​a·​second·​SIGINT·​at·​this·​stage,​·​or·​another·​non-​drastic5 servers.​</​p><p>If·​it·​receives·​a·​second·​SIGINT·​at·​this·​stage,​·​or·​another·​non-​drastic
6 signal·​at·​any·​time,​·​it·​will·​discard·​any·​partially·​downloaded·​articles·​then6 signal·​at·​any·​time,​·​it·​will·​discard·​any·​partially·​downloaded·​articles·​then
7 try·​to·​log·​off·​from·​any·​servers·​but·​not·​wait·​for·​acknowledgement.​</​p></​div><div·​class="navfooter"><hr​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ar01s10.​html">Prev</​a>&#160;​</​td><td·​width="20%"·​align="center">&#160;​</​td><td·​width="40%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s12.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Score-​based·​killfiling&#160;​</​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top">&#160;​Contact·​details</​td></​tr></​table></​div></​body></​html>7 try·​to·​log·​off·​from·​any·​servers·​but·​not·​wait·​for·​acknowledgement.​</​p></​div><div·​class="navfooter"><hr​><table·​width="100%"·​summary="Navigation·​footer"><tr><td·​width="40%"·​align="left"><a·​accesskey="p"·​href="ar01s10.​html">Prev</​a>&#160;​</​td><td·​width="20%"·​align="center">&#160;​</​td><td·​width="40%"·​align="right">&#160;​<a·​accesskey="n"·​href="ar01s12.​html">Next</​a></​td></​tr><tr><td·​width="40%"·​align="left"·​valign="top">Score-​based·​killfiling&#160;​</​td><td·​width="20%"·​align="center"><a·​accesskey="h"·​href="index.​html">Home</​a></​td><td·​width="40%"·​align="right"·​valign="top">&#160;​Contact·​details</​td></​tr></​table></​div></​body></​html>