Date:	Wed, 1 Feb 2012 18:01:01 -0800
From:	Josh Triplett <josh@...htriplett.org>
To:	"Paul E. McKenney" <paulmck@...ux.vnet.ibm.com>
Cc:	linux-kernel@...r.kernel.org, mingo@...e.hu, laijs@...fujitsu.com,
	dipankar@...ibm.com, akpm@...ux-foundation.org,
	mathieu.desnoyers@...ymtl.ca, niv@...ibm.com, tglx@...utronix.de,
	peterz@...radead.org, rostedt@...dmis.org, Valdis.Kletnieks@...edu,
	dhowells@...hat.com, eric.dumazet@...il.com, darren@...art.com,
	fweisbec@...il.com, patches@...aro.org
Subject: Re: [PATCH RFC tip/core/rcu 01/41] rcu: Bring RTFP.txt up to date.

On Wed, Feb 01, 2012 at 05:33:05PM -0800, Paul E. McKenney wrote:
> On Wed, Feb 01, 2012 at 04:18:14PM -0800, Josh Triplett wrote:
> > On Wed, Feb 01, 2012 at 11:41:19AM -0800, Paul E. McKenney wrote:
> > > @@ -173,6 +192,14 @@ Bibtex Entries
> > >  ,volume="5"
> > >  ,number="3"
> > >  ,pages="354-382"
> > > +,note="Available:
> > > +\url{http://portal.acm.org/citation.cfm?id=320619&dl=GUIDE,}
> > > +[Viewed December 3, 2007]"
> > 
> > I don't think it adds any value here to use \url{} to point to an ACM
> > paywall page.  The journal, volume, number, and title already provide
> > enough information for anyone to grab the article from their source of
> > choice.
> 
> The portal.acm.org URL is useful to people with subscriptions to ACM
> digital library.  But yes, I am expecting readers to understand how to
> use a search engine.  Judging from a few comments to some of my blog
> entries, not everyone has that understanding, but hey, they can't learn
> any younger!  ;-)

I just meant that various paywalls exist to provide access to published
papers, and anyone with a subscription to any such paywall will know how
to get papers from it.  Pointing to one in particular doesn't seem
appropriate.

> > > +@...icle{BarbaraLiskov1988ArgusCACM
> > > +,author = {Barbara Liskov}
> > > +,title = {Distributed programming in {Argus}}
> > > +,journal = {Commun. ACM}
> > > +,volume = {31}
> > > +,number = {3}
> > > +,year = {1988}
> > > +,issn = {0001-0782}
> > > +,pages = {300--312}
> > > +,doi = {http://doi.acm.org/10.1145/42392.42399}
> > 
> > Similarly I don't think a DOI provides any value; it just redirects to
> > the same ACM paywall.  The ACM sticks one into the BibTeX entries they
> > autogenerate, but I'd suggest stripping it out.  This goes for the
> > several other entries in this patch that add DOI URLs of various forms.

As above.

> > > +@...ublished{PaulEMcKenney2007WG21DDOatomics
> > > +,Author="Paul E. McKenney and Hans-J. Boehm and Lawrence Crowl"
> > > +,Title="C++ Data-Dependency Ordering: Atomics and Memory Model"
> > > +,month="August"
> > > +,day="3"
> > > +,year="2007"
> > > +,note="Available:
> > > +\url{http://open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2664.htm}
> > > +[Viewed December 7, 2009]"
> > > +,annotation="
> > > +	RCU for C++, parts 1 and 2.
> > > +"
> > > +}
> > > +
> > > +@...ublished{PaulEMcKenney2007WG21DDOannotation
> > > +,Author="Paul E. McKenney and Lawrence Crowl"
> > > +,Title="C++ Data-Dependency Ordering: Function Annotation"
> > > +,month="September"
> > > +,day="18"
> > > +,year="2008"
> > > +,note="Available:
> > > +\url{http://open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2782.htm}
> > > +[Viewed December 7, 2009]"
> > > +,annotation="
> > > +	RCU for C++, part 2, updated many times.
> > > +"
> > > +}
> > 
> > Considering their status as published documents of a standards
> > organization, why do these two use @unpublished?  (The same goes for
> > many other entries currently using @unpublished, but it seems
> > particlarly notable here.)
> 
> Because the published version is behind a paywall.  ;-)

The versions you linked to seem sufficiently published to me. :)

You could always change the note to "Preprint:".

> > > +# MathieuDesnoyers2007call_rcu_schedNeeded
> > > +@...ublished{MathieuDesnoyers2007call:rcu:schedNeeded
> > 
> > Why the comment here?
> 
> For me to sort out old papers using an earlier bibtex label.

Ah, fair enough.

> I had to
> change the name when latex started getting angry about underscores in
> bibtex labels.

\usepackage{underscore} didn't fix that?

> > > +@...hreport{PaulEMcKenney2011cyclicRCU
> > > +,author="Paul E. McKenney"
> > > +,title="Efficient Support of Consistent Cyclic Search With Read-Copy Update"
> > > +,institution="US Patent and Trademark Office"
> > > +,address="Washington, DC"
> > > +,year="2008"
> > 
> > Why does this use the tag PaulEMcKenney2011cyclicRCU given the year of
> > 2008?
> 
> Application date vs. grant date.

Not in this case, though.  This one should have the year as either 2008
or 2010 depending on which date you count.

> > > +@...ublished{EvgeniyPolyakov2009EllipticsNetwork
> > > +,Author="Evgeniy Polyakov"
> > > +,Title="The Elliptics Network"
> > > +,month="April"
> > > +,day="17"
> > > +,year="2009"
> > > +,note="Available:
> > > +\url{http://www.ioremap.net/projects/elliptics}
> > > +[Viewed April 30, 2009]"
> > > +,annotation="
> > > +	Distributed hash table with transactions, using elliptic
> > > +	hash functions to distribute data.
> > > +"
> > > +}
> > 
> > Could you add a note in this annotation about how this relates to RCU,
> > and thus why it appears in this bibliography?
> 
> Hmmm...  I removed this as well.  Evgeniy was apparently considering
> using user-level RCU, but last I heard did something else instead.

Ah, OK.

> > >  @unpublished{JoshTriplett2009RPHash
> > >  ,Author="Josh Triplett"
> > >  ,Title="Scalable concurrent hash tables via relativistic programming"
> > > @@ -860,6 +2146,7 @@ Revised:
> > >  ,note="Linux Plumbers Conference presentation"
> > >  ,annotation="
> > >  	RP fun with hash tables.
> > > +	Superseded by JoshTriplett2010RPHash
> > 
> > No, the OSR paper doesn't supercede the LPC presentation.  Also, not
> > @unpublished (which applies to quite a few other entries here, but in
> > particular this one).
> 
> I did s/Superseded by/See also/ -- is that OK?

Seems sensible.

> What bibtex entry type do you suggest for presentation-only conferences?

I use InProceedings for conferences in general:

@InProceedings{rcu-hash-lpc,
  author = {Josh Triplett},
  title = {{Scalable Concurrent Hash Tables via Relativistic Programming}},
  booktitle = {Linux Plumbers Conference 2009},
  year = 2009,
  address = {Portland, OR},
  month = {September}
}

> > > +@...icle{JoshTriplett2010RPHash
> > > +,author="Josh Triplett and Paul E. McKenney and Jonathan Walpole"
> > > +,title="Scalable Concurrent Hash Tables via Relativistic Programming"
> > > +,journal="ACM Operating Systems Review"
> > > +,year=2010
> > > +,volume=44
> > > +,number=3
> > > +,month="July"
> > > +,annotation={
> > > +	RP fun with hash tables.
> > > +	http://portal.acm.org/citation.cfm?id=1842733.1842750
> > > +}}
> > 
> > Same comment about ACM URLs: not useful.
> 
> Same reply.

Same reply. :)

> > > +@...hreport{JoshTriplett2011RPScalableCorrectOrdering
> > > +,author = {Josh Triplett and Philip W. Howard and Paul E. McKenney and Jonathan Walpole}
> > > +,title = {Scalable Correct Memory Ordering via Relativistic Programming}
> > > +,year = {2011}
> > > +,number = {11-03}
> > > +,institution = {Portland State University}
> > > +,note = {\url{http://www.cs.pdx.edu/pdfs/tr1103.pdf}}
> > > +}
> > 
> > I'd suggest dropping this tech report in favor of the much better
> > rewritten version that'll become available this month. :)
> 
> Sounds like a job for the next revision of RTFP.txt.  ;-)

Fair enough; I'll send a patch then. :)

- Josh Triplett
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/

Powered by blists - more mailing lists