Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-10 Thread Stuart Herbert
Hi Nathan,

On Thu, 2005-11-03 at 20:36 -0500, Nathan L. Adams wrote:
 So you installed your server without reading *any* documenation? (Don't
 lie). And you expect that the average user installs a Gentoo server
 without at least referencing the documentation? Pa-leaze.

I've been following your posts in this thread.  I'm not finding your
contribution to be very helpful to what we're trying to achieve here.
What are *you* trying to achieve, other than making yourself look like
an idiot?

Or, to put it another way ...

Stop being a muppet.  If Ciaran needed to refer to the documentation
(which I very much doubt), he could read the text-only version included
on the install media, or he could use a browser on another machine to
access it.

Please start taking a moment to *think* before putting your foot into
your mouth.

Best regards,
Stu
-- 
Stuart Herbert [EMAIL PROTECTED]
Gentoo Developer  http://www.gentoo.org/
  http://stu.gnqs.org/diary/

GnuGP key id# F9AFC57C available from http://pgp.mit.edu
Key fingerprint = 31FB 50D4 1F88 E227 F319  C549 0C2F 80BA F9AF C57C
--


signature.asc
Description: This is a digitally signed message part


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-07 Thread Luca Barbato

Nathan L. Adams wrote:


So you're saying that Gentoo consists of projects that are completely
'silo'd up' and have no bearing whatsoever on each other. Then the
DevRel project only has bearing on those who actually join DevRel. Neat,
a group formed for the sole purpose of coordinating itself. Security
need only concern itself with securing its members (from who knows
what!), and infra can just ignore the needs of everyone else (different
project!). I wonder how any of the other projects *ever* made it onto
the website...


Sigh, every project can set up it's own rules for internal project 
tasks, that means that internal docs could be a set of nice ascii art 
and then, you have a nice GuideXML page to point to them than happens to 
be translated on html/pdf/plaintext/whatever upon the necessities.





The errata.g.o (not the summaries w/ link that emerge would output)
would obviously be documentation, would obviously be governed by the Doc
rules, and it would be irrelevant which staff member happened to publish
a particular guide. If Gentoo really is as balkanized as you state, then
it is a sad state of affairs indeed. Maybe the 'full fledged' versions
should be GuideXML-lite or something, I'm not sure, but your argument is
just silly.


ARGH looks like MANY people do not get what is good about xml and what 
is not so good.


The whole point of using GuideXML is to make EASY convert to something 
else. NOT to use it.


The problem of using xml everywhere is that it is harder to write and 
has some work required in order to be parsed and translated.


So, if I have to set up an infrastructure that would require me to 
generate pdf, webpages, text, younameitwegetit and to update/write it 
not so often and not so quickly, I'd use xml.


If there is something that I'd have to write often by hand and quickly 
and has to be used as is mostly. I'd stay with a simpler format (that 
maybe is still machine parsable).


That said the format Ciaranm suggests for news looks ok for me. XML 
won't add anything but slowing me.


For an errata site GuideXML or an _extended_ version of it could be useful.

lu


-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDa5WH2QTTR4CNEQARAlERAKCeVue4ATD4fXBgLGdRAWt4Gi7vWgCcCs7R
w/Pvjk9vv2C00HmrTkhBnHU=
=Eiba
-END PGP SIGNATURE-



--

Luca Barbato

Gentoo/linux Developer  Gentoo/PPC Operational Leader
http://dev.gentoo.org/~lu_zero

--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-06 Thread Marius Mauch
On Fri, 4 Nov 2005 22:50:42 +0100
Jan Kundrát [EMAIL PROTECTED] wrote:

 On Friday 04 of November 2005 02:50 Lance Albertson wrote:
  After reading through the heated thread, I have yet to see your
  valid point of pushing xml for such a simple task. All I have seen
  is two 3rd grade kids arguing over a swing set. Please give some
  calm reasons for your opinion instead of voicing things in such a
  heated manner. Making assumptions about someone else's opinions
  gets you no where.
 
 Well, my point is that our GLSAs and the associated code already
 handles stuff very similar to the `emerge --news` idea, namely:
 
 a) displaying info only for users having affected package
 b) support for arch-specific issues
 c) version-specific messages
 d) instructions on how to make a workaround and how to fix the
 problem permanently

All of these steps are more or less trivial, there is little to no gain
in reusing glsa related code. Moving the relevant code from glsa.py to
some other location would be more work that rewriting these parts.

Marius

-- 
Public Key at http://www.genone.de/info/gpg-key.pub

In the beginning, there was nothing. And God said, 'Let there be
Light.' And there was still nothing, but you could see a bit better.


pgpDzaq8lgkwl.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Wernfried Haas
On Fri, Nov 04, 2005 at 12:42:47AM +, Ciaran McCreesh wrote:
 Read the list of requirements in the GLEP. The plain text solution
 meets all of them. XML fails on several.

 And, incidentally, I came up with the requirements list *before*
 dismissing XML.

Sorry, but this is too funny. 
You don't like XML.
You wrote the requirements.
You decided XML doesn't meet those requirements.
So even if you come up with the requirements *before* chances are
approximately 97% XML will fail.

I don't know if XML _is_ the right thing for this job, but i think you
are definitely biased towards it.

cheers,
Wernfried

-- 
Wernfried Haas (amne) - amne at gentoo dot org
Gentoo Forums: http://forums.gentoo.org
IRC: #gentoo-forums on freenode - email: forum-mods at gentoo dot org
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread John Myers
[[ACK! I sent this out from the wrong address before. Hope you don't get it 
twice!]]
On Thursday 03 November 2005 21:44, Nathan L. Adams wrote:
 No, I happen to understand the that point. Emerge outputting a short
 summary is great. But the GLEP should cover the hey mr. end user, the
 central repository for errata/full fledged migration guides is here:
 [insert url] as well.
[snip]
 I happen to think that the assumption that the errata are going to be
 small is a bad one. I think if errata is neccessary in the first place
 then its going to be something larger than a screen's worth of console
 output and worth the supposed trouble of GuideXML. So why not approach
 it from the GuideXML end first, and extract the summary from that?
Here's an idea for a compromise solution. Sorry it's so messy:

The errata entries would consist of two files per language:
- An emerge news file, identical to the format ciaranm proposed.
This file would give a very general notice of the issue, such as that 
given as an example in the GLEP, as well as containing the 
machine-readable commands for portage to control display.
  This file's name would end in .news.LC.txt
- A GuideXML-formatted errata document.
This would be the actual migration guide, such as the contents of the
 http://www.gentoo.org/doc/en/yoursql-upgrading.xml
referenced by the example.
  This file's name would end in .guide.LC.xml
- The leading part of the filename would be as in ciaranm's GLEP

Once it is time for the errata item to be published (after review, etc.), the 
files would be placed in a standard location, where an automated process 
would pick them up. The news files would be transferred to the Portage tree 
for emerge to pick up, and simultaneously published to a central errata 
website, e.g. http://errata.gentoo.org/. On the errata website, *all* errata 
notices would be published to its front page, unless specified differently by 
each individual user (perhaps a feature storing filters in a cookie). Each 
entry in the list would contain at least the publication date, the title of 
the news item as a link to a news item page, and the title of the guideXML 
document as a link to the document. 

Errata items would be accessible in a uniform namespace with names derived 
from their source filenames. For example:
2005-11/2005-11-01-mysql-4.0-4.1-upgrade.news.en.txt
2005-11/2005-11-01-mysql-4.0-4.1-upgrade.guide.en.xml
might become:
http://errata.gentoo.org/2005-11-01-mysql-4.0-4.1-upgrade/en/
http://errata.gentoo.org/2005-11-01-mysql-4.0-4.1-upgrade/en/guide.xml

For user convenience, URLs with language codes the text is not yet translated 
to, as well as URLs without a language code, should be redirected to the 
English version.

Errata items may be published in other areas for wider exposure, but should 
always contain a link back to the main source.

The news item page would contain a copy of the news text typeset in a 
fixed-width font, and with links made clickable, as well as a prominent link 
to the GuideXML document. The title of the page should be the title of the 
news item, and the title of the link to the GuideXML page should be the title 
of the GuideXML document.

Questions? Comments? 


pgpHAcs3R8c1G.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Paul de Vrieze
On Friday 04 November 2005 02:24, Nathan L. Adams wrote:
 I have read it, and I find it lacking; thus the comments. Or are you
 claiming that the idea of having a central website like errata.g.o with
 GuideXML-ized migrations guides is in your GLEP? Its not. I'm proposing
 adding that as the definative source of the errata, and feeding it to
 other places (emerge --news, mailing lists, forums, GWN) as desired.

I agree with Ciaran here. Emerge --news should be authoritive. I'm not 
opposed to erata.gentoo.org, but it is easy to generate from the tree. If 
there would be a master format to generate both from, that would also be 
OK, but news items in the tree is probably the best answer. And it is 
easy to display when pretending. One could even give a warning (in 
advance) when a user is trying to update an affected package (perhaps 
this should be an extra header item).


 I'm also commenting on the part that *wrongly* states It is not
 reasonable to expect all users to have an MTA, *web browser*, email
 client, cron daemon or text processing suite available on their system.
 In particular, this means that any markup to be parsed must be in a
 very simple format.

 *ALL* of the official docs are GuideXML; Gentoo *expects* users to have
 a web browser by default. Otherwise a vast majority of users would
 never get Gentoo installed in the first place. The lightweight
 requirement appears to just be your way of subverting the current
 documentation standards (because of your XML hatred).

No, gentoo expects people to have access to a webbrowser. But not all the 
time. It is perfectly reasonable to expect people to make a nice printout 
of the handbook at the office, and then take it at home to install a nice 
new gentoo box.

 The news directory shouldn't the main source of the migration guides;
 the website should be (one central page that can feed other sources).

The website should not as it a pull source of information. It requires 
users to actively acquire the information. What is worse is that some 
users might not update for a prolongued time (6 months). At that time 
they will not find the information in the erata list anymore. But they 
will get the RELEVANT news delivered by emerge/enews.

Paul

-- 
Paul de Vrieze
Gentoo Developer
Mail: [EMAIL PROTECTED]
Homepage: http://www.devrieze.net


pgp2kaCNoMG4z.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Paul de Vrieze
On Friday 04 November 2005 02:36, Nathan L. Adams wrote:
 Ciaran McCreesh wrote:
 
  I don't have a web browser installed on my server. Do you?

 So you installed your server without reading *any* documenation? (Don't
 lie). And you expect that the average user installs a Gentoo server
 without at least referencing the documentation? Pa-leaze.

I expect the average user to make a nice printout of the handbook. The 
print version of the handbook was provided mainly on user request you 
know. It also works a lot easier than either flipping screens to 
links/lynx all the time or running up and down to another computer (if 
available).

Paul

-- 
Paul de Vrieze
Gentoo Developer
Mail: [EMAIL PROTECTED]
Homepage: http://www.devrieze.net


pgpGLH2Tizwau.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Paul de Vrieze
On Friday 04 November 2005 02:43, Nathan L. Adams wrote:
 Brian Harring wrote:
  Not necessarily the website imo, some central store where it's pushed
  out to all of the locations though (which I suspect you're getting
  at).

 I forgot to clarify one point. I'm saying that http://errata.g.o/
 should be the *official* source where users go to find the info, not
 neccessarity the place where the raw data is stored and pushed to other
 places (although it certainly could be).

I'm saying that /usr/portage/news should be the *official* source where 
users should go to find the info. http://erata.g.o would be a secondary 
source, that while officially supported, is not the main source. 

The reason is that errata.g.o would not be able to offer the same user 
experience as emerge --news would. errata.g.o does NOT know about the 
local system (nor should it), and thus might be bloated with unneeded 
information. When I'm working at updating a system, I'm not interested in 
knowing that winex-cvs has been removed at transgaming's request (old 
news, as example). If however I was someone using winex-cvs, I'd be very 
interested. See the point.

Paul

-- 
Paul de Vrieze
Gentoo Developer
Mail: [EMAIL PROTECTED]
Homepage: http://www.devrieze.net


pgp8MtoD7JKcb.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Paul de Vrieze
On Friday 04 November 2005 02:52, Nathan L. Adams wrote:
 Let me say it one more time. I'm not saying you have to have a web
 browser installed on the system that you are updating or installing.
 I'm saying that the GuideXML docs are the standard, official source of
 documentation and the same should hold true for the migration guides.
 I'm also saying that feedback from users said they want ONE official
 place to find this stuff. Therefor any plan that doesn't take both of
 those things into account is silly. And having the GuideXML-ized guides
 on a central website marked as the 'official-one-stop-for-errata' does
 not in any way shape or form preclude anyone from mirroring that info
 in a text file, forum post, emerge --news, mailing list, etc. etc. ad
 nauseum.

GuideXML would not be an appropriate format in any case. GuideXML is too 
bloated with presentation items to be of use for such a purpose. While 
one could argue for an xml source version, it would certainly not be 
guidexml. This is also not necessary as it is possible to easilly apply 
double transformations by first transforming a file into guidexml and 
then into html. Look at the herds.xml file or projectxml for an example 
of this.

Paul

-- 
Paul de Vrieze
Gentoo Developer
Mail: [EMAIL PROTECTED]
Homepage: http://www.devrieze.net


pgpPVzeKlt0GC.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Paul de Vrieze
On Friday 04 November 2005 09:32, John Myers wrote:
 [[ACK! I sent this out from the wrong address before. Hope you don't
 get it twice!]]

 On Thursday 03 November 2005 21:44, Nathan L. Adams wrote:
  No, I happen to understand the that point. Emerge outputting a short
  summary is great. But the GLEP should cover the hey mr. end user,
  the central repository for errata/full fledged migration guides is
  here: [insert url] as well.

 [snip]

  I happen to think that the assumption that the errata are going to be
  small is a bad one. I think if errata is neccessary in the first
  place then its going to be something larger than a screen's worth of
  console output and worth the supposed trouble of GuideXML. So why not
  approach it from the GuideXML end first, and extract the summary from
  that?

 Here's an idea for a compromise solution. Sorry it's so messy:

 The errata entries would consist of two files per language:
 - An emerge news file, identical to the format ciaranm proposed.
 This file would give a very general notice of the issue, such as
 that given as an example in the GLEP, as well as containing the
 machine-readable commands for portage to control display.
   This file's name would end in .news.LC.txt
 - A GuideXML-formatted errata document.
 This would be the actual migration guide, such as the contents of
 the http://www.gentoo.org/doc/en/yoursql-upgrading.xml
 referenced by the example.
   This file's name would end in .guide.LC.xml
 - The leading part of the filename would be as in ciaranm's GLEP

Oh god help. This also points to another reason why this is not such a 
good idea. Writing guideXML is a lot more work than writing an e-mail 
format file (ciaran's proposed format for those who didn't recognize it).

Also having double files containing the same information is broken by 
design. This doesn't mean that all information should be in the news 
file. Let me give an example that would have been relevant some time ago.

Title: Incompatible subversion repository change
Author: Paul de Vrieze [EMAIL PROTECTED]
Content-Type: text/plain
Posted: 2005-11-04
Version: 1
Display-If-Installed: dev-util/subversion-0.34.0

Subversion has a new repository layout. This new layout is incompatible 
with repositories created with versions before 0.34.0. If you only use 
this machine as client, there are no consequences.

If this machine contains repositories however, these must be dumped before 
installing =dev-util/subversion-0.34.0. After installation new 
repositories can be created and the dumps can be reloaded.

For more information on dumping and loading see the subversion migration 
guide:
http://subversion.tigris.org/subversion_migration.


the above url is not correct, everything else would have been

If I have to write such a file in guidexml it would be a lot more 
complicated. Further this news item would only be relevant to people 
providing older subversion repositories wanting to update. As erata would 
contain all these files, it would be a swamp, hard to wade through.

I also fail to see where such a file as illustrated above is unclear to 
read. I prefer it over a bloated webpage with all kinds of slowness and 
eyecandy.

Paul

-- 
Paul de Vrieze
Gentoo Developer
Mail: [EMAIL PROTECTED]
Homepage: http://www.devrieze.net


pgpjcJU3Pv71j.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Tres Melton
On Thu, 2005-11-03 at 19:29 -0500, Nathan L. Adams wrote:

 rant
 You're just missing the fact that a flat file (or whatever it is you're
 clinging to; for the purpose of this rant, I shall refer to your simple
 data format as flat file) has trade-offs, just like XML's trade off is
 parsing overhead. XML was designed to solve certain problems;
 portability of data, separation and portability of presentation from the
 data, etc. Complexity in the parser is the trade-off.
 
Perhaps I'm missing something here but I thought the concept of --news
is to get information in front of as many eyes as possible.  It seems
that information could just as easily be:


This upgrade is going to be a PITA and we highly recommend that you read
one (or more) of the following resources before proceeding:

http://www.gentoo.org/wherever/upgrade-instructions
http://forums.gentoo.org/thread=whatever
http://lists.gmane.org/link-to-mail-thread.

You have been warned.  Have a nice day. (tm)


This would have the simplicity of a flat file and all the functionality
of XML at once so we can eat our cake too.  Just a thought.

 
 Nathan
 -BEGIN PGP SIGNATURE-
 Version: GnuPG v1.4.1 (GNU/Linux)
 
 iD8DBQFDaqt52QTTR4CNEQARAoQ1AJ42ItHkJ37eFUY8rSoGpN/dVoKIFACeJi7b
 KW6/pzn8VEKi3hO0Gqomsms=
 =cSQh
 -END PGP SIGNATURE-

Best Regards,
-- 
Tres Melton
IRC  Gentoo: RiverRat

-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Thierry Carrez
Paul de Vrieze wrote:

 Oh god help. This also points to another reason why this is not such a 
 good idea. Writing guideXML is a lot more work than writing an e-mail 
 format file (ciaran's proposed format for those who didn't recognize it).
 
 Also having double files containing the same information is broken by 
 design.

OK so there is two options :

1- every news requires a GuideXML/RST/whatever errata at a central web
location
Pros:
- non-portage user can easily browse errata
- consistency in documentation
Cons:
- work overhead for errata-writing dev

2- every news requires just a short text-based item, extra doc is optional
Pros:
- flexibility: short news don't require writing extra doc
- external doc reuse: the documentation referenced in the news item can
be some upstream upgrade doc when sufficient
Cons:
- lack of consistency and difficulty for non-portage users to browse

We can have the best of both worlds if we find a way to reduce the work
overhead to 0 (using some kind of news2errataXml translator ?). If we
can't, I tend to favor the second solution...

-- 
Koon
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Dan Meltzer
erm, and how exactly do you propose that the user who
doesn't-read-the-site-because-it-has-no-useful-information-currently
will learn about errata.g.o?

On 11/3/05, Nathan L. Adams [EMAIL PROTECTED] wrote:
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1

 Brian Harring wrote:
  Not necessarily the website imo, some central store where it's pushed
  out to all of the locations though (which I suspect you're getting
  at).

 I forgot to clarify one point. I'm saying that http://errata.g.o/ should
 be the *official* source where users go to find the info, not
 neccessarity the place where the raw data is stored and pushed to other
 places (although it certainly could be).
 -BEGIN PGP SIGNATURE-
 Version: GnuPG v1.4.1 (GNU/Linux)

 iD8DBQFDarzS2QTTR4CNEQARAlB7AJsHfqCVL160KApWZU7iuqNtCb9SWwCcCtRR
 D2e1H1U208kQQNzLDo9CpGk=
 =kiyo
 -END PGP SIGNATURE-
 --
 gentoo-dev@gentoo.org mailing list



-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Paul de Vrieze wrote:
 What is worse is that some 
 users might not update for a prolongued time (6 months). At that time 
 they will not find the information in the erata list anymore. But they 
 will get the RELEVANT news delivered by emerge/enews.

Why would a SomeSQL 1.0 to 1.1 guide ever need to dissappear? Surely
errata.g.o would have archiving/searching. But I do see your point about
emerge filtering out the unwanted stuff.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDa2RQ2QTTR4CNEQARAv0fAKCFOH6RedaYBSG069nX+aAtmQ/YWgCgjVlE
RAF3N34PDvrtY88ks3QwRhc=
=b+7v
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Thierry Carrez wrote:
 Paul de Vrieze wrote:

Oh god help. This also points to another reason why this is not such a 
good idea. Writing guideXML is a lot more work than writing an e-mail 
format file (ciaran's proposed format for those who didn't recognize it).

Also having double files containing the same information is broken by 
design.

By the way, we're talking about 1 source file being translated into
multiple formats (email for the mailing list, news blurb for GWN, etc),
and the idea is far from broken.

 
 OK so there is two options :
 
 1- every news requires a GuideXML/RST/whatever errata at a central web
 location

[snip]

 2- every news requires just a short text-based item, extra doc is optional
 Pros:

[snip]

 We can have the best of both worlds if we find a way to reduce the work
 overhead to 0 (using some kind of news2errataXml translator ?). If we
 can't, I tend to favor the second solution...
 

This is a wonderful comprimise. And one might even sucker me into
helping write the tool.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDa2ZE2QTTR4CNEQARAvNVAJ4+q94QFV+fik4FRCywX1N1Yh1s9QCfab7m
trmF40e9e33usGS7EbpMjoQ=
=tPJE
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Xavier Neys

Ciaran McCreesh wrote:

On Wed, 2 Nov 2005 19:33:37 +0100 Jan Kundrát [EMAIL PROTECTED] wrote:
| Once this tool is implemented and well tested it can be integrated
| into portage.

can ! will. It might, but don't count on it.

| GLSA already contains stuff for marking items as valid only for given
| systems, for injecting them etc. Why don't use existing code? Why
| duplication?

Because it's quicker to invent a wheel which is actually round.


Reinventing rounder wheels seems to be a common hobby.


|  You think XML magically makes things compatible? Then I suggest you
|  write a GuieXML to Docbook conversion tool, and see how many
|  thousand lines of XSLT it takes. All XML does is move the
|  conversion and parsing problems to a different, more complex level.
| 
| I'm not familiar with DocBook, but I doubt I'll need thousands of

| lines of code.

Oh? Our GuideXML to HTML conversion is thousands of lines of code...


Plain wrong, but you have always made it clear that you are not only biased 
against XML for anything, but also very much XML challenged.
Don't worry, some are even worse than you are, worse enough to claim that XML 
is hard to parse because XML files from a programming perspective require 
extra logic to parse. Compare the following key value pair and xml tag pseudo 
parsing logic for configuration:

tag1entry/tag1
Hit a , tag1 as realized tag name, read until , read ahead one to ensure a 
closing slash, read until  to get the tag name, compare tag name with 
previous tag name to see what tag it's closing. store value attached to tag1.


Just a short sample against metadata.xml using ruby/dom instead of python/sax:
http://dev.gentoo.org/~neysx/metax.rb

Discarding XML for the reasons some are using is like recommending key=value 
flat .ini files because windows used it in the 80s.
They have to be parsed as well, and, as opposed to XML, you have to check for 
unknown keys, double keys, missing ones, then you need some grouping and you 
introduce [sections], which you have to check as well, no doubles, no missing 
ones, no illegal ones, then you need a deeper hierarchy and you use 
key=/path/to/another/file.ini...


Both have reasons to be used, neither is a one-fits-all answer.

Anyway, this is getting off-topic, and, FWIW, I believe the suggested format 
is adequate because it is light, easy to write, read, parse, and even 
transform into XML should one process ever need it. Besides, it is very much 
standard, if it's good enough for billions of mail and http messages a day, 
it's probably good enough for us.


--
/  Xavier Neys
\_ Gentoo Documentation Project
/  French  Internationalisation Lead
\  http://www.gentoo.org/doc/en
/\


--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Xavier Neys

Thierry Carrez wrote:

Paul de Vrieze wrote:


Oh god help. This also points to another reason why this is not such a 
good idea. Writing guideXML is a lot more work than writing an e-mail 
format file (ciaran's proposed format for those who didn't recognize it).


Also having double files containing the same information is broken by 
design.



OK so there is two options :

1- every news requires a GuideXML/RST/whatever errata at a central web
location
Pros:
- non-portage user can easily browse errata
- consistency in documentation
Cons:
- work overhead for errata-writing dev

2- every news requires just a short text-based item, extra doc is optional
Pros:
- flexibility: short news don't require writing extra doc
- external doc reuse: the documentation referenced in the news item can
be some upstream upgrade doc when sufficient
Cons:
- lack of consistency and difficulty for non-portage users to browse

We can have the best of both worlds if we find a way to reduce the work
overhead to 0 (using some kind of news2errataXml translator ?). If we
can't, I tend to favor the second solution...


Both can be done.
Posting news items on our front page can be done today, publishing upgrade 
notes can be done today, grouping all upgrade documents in an upgrade category 
on the main doc index (docs.gentoo.org) can be done today, having 
upgrade.gentoo.org point to it can be done one hour later.

All of the above does not require a single line of code.

I suppose the news snippets could also be integrated in packages.gentoo.org, 
hopefully without requiring too much work.


--
/  Xavier Neys
\_ Gentoo Documentation Project
/  French  Internationalisation Lead
\  http://www.gentoo.org/doc/en
/\
--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Lance Albertson
Ciaran McCreesh wrote:

 News Item Source
 
 
 News items are to be made available via the Portage tree. This removes any
 need for polling of a remote source.
 
 A new directory, ``news/``, will be created in the main tree.  Commit access
 to this directory will be handled in the same way as for the rest of the
 tree. This directory will contain further subdirectories named
 ``-mm/``, where ```` is the current year and ``mm`` is the current
 month number (01 for January through 12 for December) -- this extra level
 of separation will help keep news items more manageable.

Could we possibly use a system thats a mix of how GLSA's and GLEP's are
handled currently? The main point here being that we can move the actual
cvs location outside of gentoo-x86 and put it in somewhere more
appropriate for translators. The example here is, all the GLSA's are
currently not in the gentoo-x86 module. The regeneration script on our
master mirror syncs with the gentoo module location for GLSA's and
copies those files in its current location in the tree.

Perhaps we could do the same for the news item where they actually
reside in the documentation module and the 'plain text' versions of the
files get copied into the tree at regen time. Correct me if I'm wrong,
but I think GLEPs are currently created as RST files then you use a
converter script to make it in guidexml. Then you actually commit both
the rst and xml file to cvs. Could we possibly do the same here to make
it simple? Automation is great where it fits best. I'd rather not deal
with conversion on the server end, I'd prefer the conversion be handled
by the developer/translator as they can double check the conversion
script better than the script itself can.

Poke at that :-)

Cheers-

-- 
Lance Albertson [EMAIL PROTECTED]
Gentoo Infrastructure | Operations Manager

---
GPG Public Key:  http://www.ramereth.net/lance.asc
Key fingerprint: 0423 92F3 544A 1282 5AB1  4D07 416F A15D 27F4 B742

ramereth/irc.freenode.net


signature.asc
Description: OpenPGP digital signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Chris Gianelloni wrote:
 On Thu, 2005-11-03 at 20:24 -0500, Nathan L. Adams wrote:
 
*ALL* of the official docs are GuideXML; Gentoo *expects* users to have
a web browser by default. Otherwise a vast majority of users would never
get Gentoo installed in the first place. The lightweight requirement
appears to just be your way of subverting the current documentation
standards (because of your XML hatred).
 
 
 *sigh*
 
 Then I guess we're wasting our time getting the Handbook converted to
 plain text for *every* release.  It's on the CD itself, have a look.  No
 need for a web browser of any kind.
 
 You really need to check your facts before posting.
 

I've done several Gentoo installs and never knew the plain text versions
existed. I think you might want to check the assumption that just
because they exists they are widely known (and if they aren't known to
exist, they don't do squat for the end user). Surely we're not going to
delve into an arguement over whether the web is the best way to
distribute information...
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDa4U92QTTR4CNEQARAjkzAJ0YS2F/6zWLZeLQ0tbvIYNIqoe1PQCfcV53
bLnhNPoCJDNGrHuIw3pxEEA=
=rSj8
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Chris Gianelloni wrote:
 On Thu, 2005-11-03 at 20:36 -0500, Nathan L. Adams wrote:
 
So you installed your server without reading *any* documenation? (Don't
lie). And you expect that the average user installs a Gentoo server
without at least referencing the documentation? Pa-leaze.
 
 
 less /mnt/cdrom/docs/handbook/txt/install.txt
 
 No web browser, so can you please quit beating this dead horse.  It
 isn't even funny anymore.
 

That's a great and wonderful alternative, but the policy is to publish
documentation in GuideXML:

http://www.gentoo.org/proj/en/gdp/doc/doc-policy.xml#doc_chap3

-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDa4a42QTTR4CNEQARAqGnAJ4gfJLCMmK5/tU5lmnszaR1fW1MSQCfTyYK
wh/HaL69456P9eOqc7sabDc=
=D8T6
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Danny van Dyk

-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Nathan L. Adams schrieb:
| 6. Ciaran is completely biased against XML (or anything that isn't
| stored as a simple flat file) ;)
On the other hand one could say that there are Gentoo-Devs which are
biased against anything that can work without using XML.

To quote Wikipedia.org[1]:
The Extensible Markup Language (XML) is a W3C-recommended
general-purpose markup language for *creating special-purpose markup
languages*. (Emphasis added by me.)

There are occasions where creating a completely new markup language with
XML does make sense. However, this particular enhancement does not need it.

IMHO a text based file has a big advantage in this proposed application
over fileformats which use XML: Any administrator can read it with his
editor of choice, right from the console.

Danny
- --
Danny van Dyk [EMAIL PROTECTED]
Gentoo/AMD64 Project, Gentoo Scientific Project
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDa4bFaVNL8NrtU6IRAgQDAJ93+rj1sI6sADnq3QCLpCWE3BYx4gCfdrv3
/6p4ZR5A0kR7akOoCEuT/44=
=8moA
-END PGP SIGNATURE-
--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Chris Gianelloni
On Fri, 2005-11-04 at 10:58 -0500, Nathan L. Adams wrote:
 I've done several Gentoo installs and never knew the plain text versions
 existed. I think you might want to check the assumption that just
 because they exists they are widely known (and if they aren't known to
 exist, they don't do squat for the end user). Surely we're not going to
 delve into an arguement over whether the web is the best way to
 distribute information...

Ehh...

It is listed in the MOTD on the installation media.  I'm not making any
assumptions on this.  It's really not our fault when the user base
doesn't read what is sitting in front of them, plainly on the screen.

Thank you for proving my point.

-- 
Chris Gianelloni
Release Engineering - Strategic Lead
x86 Architecture Team
Games - Developer
Gentoo Linux


signature.asc
Description: This is a digitally signed message part


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Chris Gianelloni
On Fri, 2005-11-04 at 11:05 -0500, Nathan L. Adams wrote:
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1
 
 Chris Gianelloni wrote:
  On Thu, 2005-11-03 at 20:36 -0500, Nathan L. Adams wrote:
  
 So you installed your server without reading *any* documenation? (Don't
 lie). And you expect that the average user installs a Gentoo server
 without at least referencing the documentation? Pa-leaze.
  
  
  less /mnt/cdrom/docs/handbook/txt/install.txt
  
  No web browser, so can you please quit beating this dead horse.  It
  isn't even funny anymore.
  
 
 That's a great and wonderful alternative, but the policy is to publish
 documentation in GuideXML:

No it isn't...

 
 http://www.gentoo.org/proj/en/gdp/doc/doc-policy.xml#doc_chap3

Yeah, see, this is a case where not understanding the structure of
Gentoo gives you the wrong impression.  The GDP's policy applies to the
GDP.  That is not a global developer policy of any kind.  It is a policy
by a project, for that project.

If I were, for example, to write up a nice guide for something on the
games team and do it all in ASCII art, that policy has no bearing on
what I do.  If I were to write something for the GDP, then it would.

At any rate, that has *zero* bearing on whether or not our update
information needs to be written in GuideXML, so there's no point in
arguing it with you.

-- 
Chris Gianelloni
Release Engineering - Strategic Lead
x86 Architecture Team
Games - Developer
Gentoo Linux


signature.asc
Description: This is a digitally signed message part


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Grobian

Danny van Dyk wrote:

IMHO a text based file has a big advantage in this proposed application
over fileformats which use XML: Any administrator can read it with his
editor of choice, right from the console.


This is an important aspect for sure, but why can't such file be 
generated from a marked up one?  Because the same message will be put in 
multiple forms (ideally) it is best to have a version with all the 
required meta-data to generate all the other formats, because if you 
have to add such meta-data it's usually much worse (= manual or 
conditional human work).


Some people like reading console messages, others plain text mail 
messages, others want html marked up mail messages, other others like 
reading an rss-feed, and of course there are people that like to read 
the full fledged funky marked up with all hyperlinks possible html 
version on the web.
I think the only real importance is that all representations can easily 
be generated from the original source, be that XML, reStructuredText or 
any other format.


With regard to being it hard to write or not, I think these kind of 
messages are very well suited for templates, so it is just a matter of 
filling in the message, which should make the underlying format not so 
important.


Just my €0.02 on the XML vs. plain text discussion.


--
Fabian Groffen
--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Chris Gianelloni wrote:
 On Fri, 2005-11-04 at 10:58 -0500, Nathan L. Adams wrote:
 
I've done several Gentoo installs and never knew the plain text versions
existed. I think you might want to check the assumption that just
because they exists they are widely known (and if they aren't known to
exist, they don't do squat for the end user). Surely we're not going to
delve into an arguement over whether the web is the best way to
distribute information...
 
 
 Ehh...
 
 It is listed in the MOTD on the installation media.  I'm not making any
 assumptions on this.  It's really not our fault when the user base
 doesn't read what is sitting in front of them, plainly on the screen.
 
 Thank you for proving my point.
 

And what point would that be exactly? Console messages are ineffective?
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDa5Ls2QTTR4CNEQARAm5NAKCiOQEkK07nz4KFfSY+5uzeUNMN2wCfUe1Q
LSTG+k4lWKo6v6Wl1AR+424=
=Ar9r
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Lance Albertson
Nathan L. Adams wrote:

It is listed in the MOTD on the installation media.  I'm not making any
assumptions on this.  It's really not our fault when the user base
doesn't read what is sitting in front of them, plainly on the screen.

Thank you for proving my point.

 
 
 And what point would that be exactly? Console messages are ineffective?

That you haven't completely read documentation that was right on your
screen. I mean *read*, not glanced. I've finally read through ciaranm's
GLEP and I get the impression you only skimmed through it. I suggest you
stick with exact wording from the GLEP for discussion on this thread
rather than assumptions made on arguments.

Cheers-

-- 
Lance Albertson [EMAIL PROTECTED]
Gentoo Infrastructure | Operations Manager

---
GPG Public Key:  http://www.ramereth.net/lance.asc
Key fingerprint: 0423 92F3 544A 1282 5AB1  4D07 416F A15D 27F4 B742

ramereth/irc.freenode.net


signature.asc
Description: OpenPGP digital signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Chris Gianelloni wrote:
 
 Yeah, see, this is a case where not understanding the structure of
 Gentoo gives you the wrong impression.  The GDP's policy applies to the
 GDP.  That is not a global developer policy of any kind.  It is a policy
 by a project, for that project.
 
 If I were, for example, to write up a nice guide for something on the
 games team and do it all in ASCII art, that policy has no bearing on
 what I do.  If I were to write something for the GDP, then it would.
 
 At any rate, that has *zero* bearing on whether or not our update
 information needs to be written in GuideXML, so there's no point in
 arguing it with you.
 

So you're saying that Gentoo consists of projects that are completely
'silo'd up' and have no bearing whatsoever on each other. Then the
DevRel project only has bearing on those who actually join DevRel. Neat,
a group formed for the sole purpose of coordinating itself. Security
need only concern itself with securing its members (from who knows
what!), and infra can just ignore the needs of everyone else (different
project!). I wonder how any of the other projects *ever* made it onto
the website...

The errata.g.o (not the summaries w/ link that emerge would output)
would obviously be documentation, would obviously be governed by the Doc
rules, and it would be irrelevant which staff member happened to publish
a particular guide. If Gentoo really is as balkanized as you state, then
it is a sad state of affairs indeed. Maybe the 'full fledged' versions
should be GuideXML-lite or something, I'm not sure, but your argument is
just silly.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDa5WH2QTTR4CNEQARAlERAKCeVue4ATD4fXBgLGdRAWt4Gi7vWgCcCs7R
w/Pvjk9vv2C00HmrTkhBnHU=
=Eiba
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Grobian wrote:
 Danny van Dyk wrote:
 
 IMHO a text based file has a big advantage in this proposed application
 over fileformats which use XML: Any administrator can read it with his
 editor of choice, right from the console.
 
 
 This is an important aspect for sure, but why can't such file be
 generated from a marked up one?  Because the same message will be put in
 multiple forms (ideally) it is best to have a version with all the
 required meta-data to generate all the other formats, because if you
 have to add such meta-data it's usually much worse (= manual or
 conditional human work).
 
 Some people like reading console messages, others plain text mail
 messages, others want html marked up mail messages, other others like
 reading an rss-feed, and of course there are people that like to read
 the full fledged funky marked up with all hyperlinks possible html
 version on the web.
 I think the only real importance is that all representations can easily
 be generated from the original source, be that XML, reStructuredText or
 any other format.
 
 With regard to being it hard to write or not, I think these kind of
 messages are very well suited for templates, so it is just a matter of
 filling in the message, which should make the underlying format not so
 important.
 
 Just my €0.02 on the XML vs. plain text discussion.
 
 

A very good point. You could even offer a web form for those who don't
even want to edit the template by hand.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDa5YF2QTTR4CNEQARAly+AKCjnT+yONZPAmTO+cccByWeQcaVsQCfQ4Vb
K8Cwc/QQNKxAe/Q0VknIOiU=
=2Dow
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Daniel Ostrow
On Fri, 2005-11-04 at 12:08 -0500, Nathan L. Adams wrote:
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1
 
 Chris Gianelloni wrote:
  
  Yeah, see, this is a case where not understanding the structure of
  Gentoo gives you the wrong impression.  The GDP's policy applies to the
  GDP.  That is not a global developer policy of any kind.  It is a policy
  by a project, for that project.
  
  If I were, for example, to write up a nice guide for something on the
  games team and do it all in ASCII art, that policy has no bearing on
  what I do.  If I were to write something for the GDP, then it would.
  
  At any rate, that has *zero* bearing on whether or not our update
  information needs to be written in GuideXML, so there's no point in
  arguing it with you.
  
 
 So you're saying that Gentoo consists of projects that are completely
 'silo'd up' and have no bearing whatsoever on each other. Then the
 DevRel project only has bearing on those who actually join DevRel. Neat,
 a group formed for the sole purpose of coordinating itself. Security
 need only concern itself with securing its members (from who knows
 what!), and infra can just ignore the needs of everyone else (different
 project!). I wonder how any of the other projects *ever* made it onto
 the website...

Yet more proof that you don't understand what you are talking
about...not meant to be insulting just stating that you don't. Just
because some groups (DevRel, Infra, etc.) have farther reaching tendrils
doesn't mean that every group does. 

For example, each arch team has a slightly different way to go about
allowing package maintainers to keyword their own packages on a given
arch...some teams insist that the maintainer join the arch team...some
allow for special arrangements (they all follow the same basic
guidelines).

With documentation there are actually 2 different types, those bits that
fall under the GDP and those that fall under the herd that uses them.
Take Chris' games example, the games team is free to release an FAQ in
plain text in Pig Latin if they want to, so long as it is on their own
project page. The GDP policy -only- covers the GDP...not anyone else, so
if Chris wanted to move his plain text Pig Latin doc to the official
Docs repository he would have to make an English version and make it
GuideXML. That's it plain and simple.

 The errata.g.o (not the summaries w/ link that emerge would output)
 would obviously be documentation, would obviously be governed by the Doc
 rules, and it would be irrelevant which staff member happened to publish
 a particular guide. If Gentoo really is as balkanized as you state, then
 it is a sad state of affairs indeed. Maybe the 'full fledged' versions
 should be GuideXML-lite or something, I'm not sure, but your argument is
 just silly.

Another thing you seem to be missing is that the GLEP specifically
separates the news from the documentation. The news or errata is just a
plain text *short* summary that something needs to be attended to. It
can, but does not always have to, link to further more detailed
*documentation*. Note then that what would go up on errata.g.o in this
case would be the *summary* (which would not necessarily be governed by
the GDP or it's policies) and *not* the full documentation. Said summary
would contain links to any relevant *documentation* which would then be
governed by the GDP if said documentation was in fact Gentoo created and
in the official Docs repository.

-- 
Daniel Ostrow
Gentoo Foundation Board of Trustees
Gentoo/{PPC,PPC64,DevRel}
[EMAIL PROTECTED]

-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Ciaran McCreesh
On Fri, 04 Nov 2005 08:37:16 -0600 Lance Albertson
[EMAIL PROTECTED] wrote:
| Could we possibly use a system thats a mix of how GLSA's and GLEP's
| are handled currently?

Sure, if that makes sense from an infra perspective.

| Perhaps we could do the same for the news item where they actually
| reside in the documentation module and the 'plain text' versions of
| the files get copied into the tree at regen time. Correct me if I'm
| wrong, but I think GLEPs are currently created as RST files then you
| use a converter script to make it in guidexml.

There is no published official RST to guidexml conversion tool that
anyone is prepared to admit to having written at this stage.

Also, you'd need to prod the docs guys to remove some of the annoying
chapter / section restrictions if you want to use guidexml as a
generated format for news items. It's hard enough mapping GLEPs onto
that...

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgptD2mgbtnrt.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Danny van Dyk

-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Xavier Neys schrieb:
| Discarding XML for the reasons some are using is like recommending
| key=value flat .ini files because windows used it in the 80s.
| They have to be parsed as well, and, as opposed to XML, you have to
| check for unknown keys, double keys, missing ones, then you need some
| grouping and you introduce [sections], which you have to check as well,
| no doubles, no missing ones, no illegal ones, then you need a deeper
| hierarchy and you use key=/path/to/another/file.ini...
He suggested using a RFC822 style Header. Please stick to the facts...

Danny
- --
Danny van Dyk [EMAIL PROTECTED]
Gentoo/AMD64 Project, Gentoo Scientific Project
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDa6+TaVNL8NrtU6IRAh7fAJ0WL6M0+KTk9uNQzIJxjS1YDVzN+ACdHMvY
OVj8WvjhXuN638d7Zs/Dvo8=
=zt9G
-END PGP SIGNATURE-
--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Lance Albertson
Ciaran McCreesh wrote:
 On Fri, 04 Nov 2005 08:37:16 -0600 Lance Albertson
 [EMAIL PROTECTED] wrote:
 | Could we possibly use a system thats a mix of how GLSA's and GLEP's
 | are handled currently?
 
 Sure, if that makes sense from an infra perspective.

Yes, I would prefer a standardish way to distribute these types of
things. GLSA's seem to work fine, but they are XML only currently and I
don't think this GLEP is heading that way. If we can nail down the
standards for local vs. remote (www) it should work fine from the infra
side.

 | Perhaps we could do the same for the news item where they actually
 | reside in the documentation module and the 'plain text' versions of
 | the files get copied into the tree at regen time. Correct me if I'm
 | wrong, but I think GLEPs are currently created as RST files then you
 | use a converter script to make it in guidexml.
 
 There is no published official RST to guidexml conversion tool that
 anyone is prepared to admit to having written at this stage.
 
 Also, you'd need to prod the docs guys to remove some of the annoying
 chapter / section restrictions if you want to use guidexml as a
 generated format for news items. It's hard enough mapping GLEPs onto
 that...

Yeah, I wondered about that too. I think the jist of this whole thread
is the www presentation level of it would most likely end up as guidexml
(unless there's a good reason to use something totally different). The
mean reason I say that is because I'm guessing most of the detailed
information will reside on the actual www nodes under the GDP which at
this time I'd like to keep in xml form. (And i'm only talking about the
presentation layer, not what you'll see in the tree).

If however, we think its better to have a totally separate vhost like
errata, we can be more flexible on the format we use to display. All I'm
after from an infra POV is something simple for us to manage and scale.

Cheers-

-- 
Lance Albertson [EMAIL PROTECTED]
Gentoo Infrastructure | Operations Manager

---
GPG Public Key:  http://www.ramereth.net/lance.asc
Key fingerprint: 0423 92F3 544A 1282 5AB1  4D07 416F A15D 27F4 B742

ramereth/irc.freenode.net


signature.asc
Description: OpenPGP digital signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Ciaran McCreesh
On Fri, 04 Nov 2005 13:12:17 -0600 Lance Albertson
[EMAIL PROTECTED] wrote:
| If however, we think its better to have a totally separate vhost like
| errata, we can be more flexible on the format we use to display. All
| I'm after from an infra POV is something simple for us to manage and
| scale.

As it stands, it's a trivially simple documentation format that can
easily be converted to any other sufficiently general markup format, so
long as said markup format doesn't impose any requirements for things
like heading structures. Would you like three lines of bash to convert
news items into a PDF? :)

There's nothing in this GLEP that precludes using the news files in
other locations. Being able to do so is even listed in the requirements
part. It wouldn't surprise me if someone just happened to come up with,
say, a forums auto-poster or a Gentoo news XML auto-conversion tool...
If there's anything in the GLEP that makes doing so harder than should
be necessary, please let me know because I'd consider that to be a
problem needing attention...

-- 
Ciaran McCreesh : Gentoo Developer (Anti-XML, anti-newbie conspiracy)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpmm07woJa55.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Jan Kundrát
On Friday 04 of November 2005 19:39 Ciaran McCreesh wrote:
 On Fri, 04 Nov 2005 15:26:28 +0100 Xavier Neys [EMAIL PROTECTED] wrote:
 |  Oh? Our GuideXML to HTML conversion is thousands of lines of code...
 |
 | Plain wrong, but you have always made it clear that you are not only
 | biased against XML for anything, but also very much XML challenged.

 Run a wc -l on guide.xsl sometime. Either wc is lying or that alone is
 thousands of lines of code.

Run a `less` or `gvim` or anything which actually displays the contents of the 
file. Are you sure that checking for obsoleted translations, highlighting 
top-page links and other stuff is really required for simple transformations?

WKR,
-jkt

-- 
cd /local/pub  more beer  /dev/mouth


pgp4lr96TnyR4.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Dan Meltzer
For simple translations? No.

For translations that span the same bredth (old version checking is
probably going to be fairly needed if we used xml as a main version,
and all other pretifying stuff is necessary.

On 11/4/05, Jan Kundrát [EMAIL PROTECTED] wrote:
 On Friday 04 of November 2005 19:39 Ciaran McCreesh wrote:
  On Fri, 04 Nov 2005 15:26:28 +0100 Xavier Neys [EMAIL PROTECTED] wrote:
  |  Oh? Our GuideXML to HTML conversion is thousands of lines of code...
  |
  | Plain wrong, but you have always made it clear that you are not only
  | biased against XML for anything, but also very much XML challenged.
 
  Run a wc -l on guide.xsl sometime. Either wc is lying or that alone is
  thousands of lines of code.

 Run a `less` or `gvim` or anything which actually displays the contents of the
 file. Are you sure that checking for obsoleted translations, highlighting
 top-page links and other stuff is really required for simple transformations?

 WKR,
 -jkt

 --
 cd /local/pub  more beer  /dev/mouth




-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Jan Kundrát
On Friday 04 of November 2005 03:30 Luis F. Araujo wrote:
 The point is not about havig access to a web browser, but to have it
 installed in the respective box reading news.

Nope, I'd substitute in the respective box with on the box that you're 
doing administrative tasks from. I rarely use physical console of a server.

Cheers,
-jkt

-- 
cd /local/pub  more beer  /dev/mouth


pgp65oUbhhPeV.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Jan Kundrát
On Friday 04 of November 2005 02:50 Lance Albertson wrote:
 After reading through the heated thread, I have yet to see your valid
 point of pushing xml for such a simple task. All I have seen is two 3rd
 grade kids arguing over a swing set. Please give some calm reasons for
 your opinion instead of voicing things in such a heated manner. Making
 assumptions about someone else's opinions gets you no where.

Well, my point is that our GLSAs and the associated code already handles stuff 
very similar to the `emerge --news` idea, namely:

a) displaying info only for users having affected package
b) support for arch-specific issues
c) version-specific messages
d) instructions on how to make a workaround and how to fix the problem 
permanently

So the code is here, as well as existing procedures to make new announcements, 
to list them on the website, forums etc.

The only disadvantage I'm aware of is that Portage would have to include XML 
parser, but as Brian said, most of Portage installations already do (sorry, 
I'm not familiar neither with stages nor with Portage, feel free to correct 
me).

WKR,
-jkt

-- 
cd /local/pub  more beer  /dev/mouth


pgpPa3rHqvhtW.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Jan Kundrát
On Friday 04 of November 2005 19:48 Ciaran McCreesh wrote:
 Also, you'd need to prod the docs guys to remove some of the annoying
 chapter / section restrictions if you want to use guidexml as a
 generated format for news items. It's hard enough mapping GLEPs onto
 that...

https://bugs.gentoo.org/ please. It's quite hard to track list of wanted 
GuideXML improvements on several places.

TIA,
-jkt

-- 
cd /local/pub  more beer  /dev/mouth


pgpqWBt0LDHIT.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Xavier Neys

Danny van Dyk wrote:

Xavier Neys schrieb:
| Discarding XML for the reasons some are using is like recommending
| key=value flat .ini files because windows used it in the 80s.
| They have to be parsed as well, and, as opposed to XML, you have to
| check for unknown keys, double keys, missing ones, then you need some
| grouping and you introduce [sections], which you have to check as well,
| no doubles, no missing ones, no illegal ones, then you need a deeper
| hierarchy and you use key=/path/to/another/file.ini...
He suggested using a RFC822 style Header. Please stick to the facts...


Had you read that bit properly, you would have noticed I was quoting someone 
else.
Had you read the post to the end, you would have realised I understand that 
and that I even support it.


--
/  Xavier Neys
\_ Gentoo Documentation Project
/  French  Internationalisation Lead
\  http://www.gentoo.org/doc/en
/\
--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Xavier Neys

Ciaran McCreesh wrote:

On Fri, 04 Nov 2005 15:26:28 +0100 Xavier Neys [EMAIL PROTECTED] wrote:
|  Oh? Our GuideXML to HTML conversion is thousands of lines of code...
| 
| Plain wrong, but you have always made it clear that you are not only

| biased against XML for anything, but also very much XML challenged.

Run a wc -l on guide.xsl sometime. Either wc is lying or that alone is
thousands of lines of code.


You know how to count. Well done.
You still haven't got a fscking clue what you're counting, though.
BTW, 1525 is not thousands.

Remove all the html that surrounds the content, i.e. the top bar with logo and 
menu, the left col with the menu and old news items, the right col with the 
ads and you're left with less than a thousand lines. Then remove the blank 
lines, comments and a bit of what I believe is dead wood but I know has 
nothing to do with GuideXML, and what's left already does a lot more than 
GuideXML to HTML transformation.



| Don't worry, some are even worse than you are, worse enough to claim
| that XML is hard to parse because XML files from a programming
| perspective require extra logic to parse. Compare the following key
| value pair and xml tag pseudo parsing logic for configuration:
| tag1entry/tag1
| Hit a , tag1 as realized tag name, read until , read ahead one to
| ensure a closing slash, read until  to get the tag name, compare tag
| name with previous tag name to see what tag it's closing. store value
| attached to tag1.

That is not parsing XML. That is parsing some arbitrary markup language
you just invented. Please read the XML specification, note how complex
some of the little used side features are, and then remember that a
compliant XML parser has to implement **all** of them.


I did not invent that, I was quoting another dev. FYI, the quote is the bit 
between the  characters.



--
/  Xavier Neys
\_ Gentoo Documentation Project
/  French  Internationalisation Lead
\  http://www.gentoo.org/doc/en
/\
--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-04 Thread Danny van Dyk

-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Xavier Neys schrieb:
| Danny van Dyk wrote:
|
| Xavier Neys schrieb:
| | Discarding XML for the reasons some are using is like recommending
| | key=value flat .ini files because windows used it in the 80s.
| | They have to be parsed as well, and, as opposed to XML, you have to
| | check for unknown keys, double keys, missing ones, then you need some
| | grouping and you introduce [sections], which you have to check as well,
| | no doubles, no missing ones, no illegal ones, then you need a deeper
| | hierarchy and you use key=/path/to/another/file.ini...
| He suggested using a RFC822 style Header. Please stick to the facts...

| Had you read that bit properly, you would have noticed I was quoting
| someone else.
| Had you read the post to the end, you would have realised I understand
| that and that I even support it.

I did read your post to the end. Still, adding things like the above
quoted INI-File talk has nothing to do with this discussions. Therefore
my demand to 'stick to the facts'.

As to the quoting: Please mark quotes as such. There maybe people who
can memorize this whole thread and recognize unmarked quotes... i can't...

Danny
- --
Danny van Dyk [EMAIL PROTECTED]
Gentoo/AMD64 Project, Gentoo Scientific Project
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDbAs9aVNL8NrtU6IRAmjKAKCNfYNw7SBbPttEK5ROy7PUgvWkGgCeM+ch
y/e6M4sYUp2/o3aZjBRREyI=
=pN17
-END PGP SIGNATURE-
--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Jan Kundrát
On Wednesday 02 of November 2005 23:34 Ciaran McCreesh wrote:
 Oh? Our GuideXML to HTML conversion is thousands of lines of code...

...including stuff for detecting outdated translations, inclusion of icons for 
the homepage etc etc.

Cheers,
-jkt

-- 
cd /local/pub  more beer  /dev/mouth


pgpU8LskoyMdl.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Ciaran McCreesh wrote:
 [a reply]

1. Store the actual guides as GuideXML at a central place such as
http://errata.gentoo.org/

2. Write a simple 'publishing' tool that extracts a summary and a link.
This is what gets pumped into portage and shown during an
# emerge --news

3. Rejoice.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDahaE2QTTR4CNEQARAmzbAJ9G3UdKnSJ1ze+KMD4jMnr7I91fMwCgm29P
1prgiQtmdk6F6qSgngCyfWY=
=P03X
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread pclouds
On 11/3/05, Nathan L. Adams [EMAIL PROTECTED] wrote:
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1

 Ciaran McCreesh wrote:
  [a reply]

 1. Store the actual guides as GuideXML at a central place such as
 http://errata.gentoo.org/

 2. Write a simple 'publishing' tool that extracts a summary and a link.
 This is what gets pumped into portage and shown during an
 # emerge --news

 3. Rejoice.
Well, i like this way. We may write a good migration article and a
summary which is used by emerge --news. This is better than just an
annoucement that something has changed. Anyone who is to make backward
incompatible changes will have to write detail guidelines in addition
to annoucement. That's good.
--
Bi Cờ Lao

-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Ciaran McCreesh
On Thu, 03 Nov 2005 08:49:42 -0500 Nathan L. Adams [EMAIL PROTECTED]
wrote:
| 6. Ciaran is completely biased against XML (or anything that isn't
| stored as a simple flat file) ;)

It's not bias. I give XML exactly what it deserves. SGML is a giant
fire breathing stomping monster useful for crushing Tokyo. XML is the
spawn of said giant fire breathing stomping monster that's had its
claws and teeth removed, its jaws glued shut, its legs chained together
and its tail nailed to the ground. And we're not trying to destroy any
large cities here...

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpZdjq1o9YtD.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Ciaran McCreesh wrote:
 On Thu, 03 Nov 2005 08:49:42 -0500 Nathan L. Adams [EMAIL PROTECTED]
 wrote:
 | 6. Ciaran is completely biased against XML (or anything that isn't
 | stored as a simple flat file) ;)
 
 It's not bias. I give XML exactly what it deserves. SGML is a giant
 fire breathing stomping monster useful for crushing Tokyo. XML is the
 spawn of said giant fire breathing stomping monster that's had its
 claws and teeth removed, its jaws glued shut, its legs chained together
 and its tail nailed to the ground. And we're not trying to destroy any
 large cities here...
 

rant
You're just missing the fact that a flat file (or whatever it is you're
clinging to; for the purpose of this rant, I shall refer to your simple
data format as flat file) has trade-offs, just like XML's trade off is
parsing overhead. XML was designed to solve certain problems;
portability of data, separation and portability of presentation from the
data, etc. Complexity in the parser is the trade-off.

Flat files can be great in certain situations. Flat files do indeed make
the parsing trivial. However SIMPLE CODE ISN'T ALWAYS THE MOST IMPORTANT
REQUIREMENT. In the case of this GLEP, the most important requirement is
getting the proper migration info to the users in the best possible way.

So what are the trade-offs of the 'flat file'? If you store a migration
guide as a 'flat file', its not going to be very readable. I would
certainly rather read info in GuideXML than some garbage output by einfo
or the like (and I'm talking about the same exact data, just a different
presentation). You're being daft if you say that your average terminal
output is easier to read and understand than the same data in proper
GuideXML format. OK, you say, you have a point there. But, you say, my
flat file allows me to write a 'presentation' proggy in relatively few
lines of trivial code. Yes, but now you have to write a new presentation
program for every type of presentation you want to do. Or worse you
would imbed the presentation in the data itself and make a new copy of
the data every time you want to present it differently. But, you say,
don't you have to do that with XML (i.e. a new style sheet definition
for each presentation)? Sure, but I don't have to re-write firefox in
the process...

So the point is that, yes, XML has a down side. But plain text, CSV
files, whatever have their downsides too. And the point of this GLEP
shouldn't be to push any XML-bashing agenda, it should be to present the
user with the migration guide in the best possible way. GuideXML is the
standard for Gentoo docs for some damn good reasons!
/rant

Nathan
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDaqt52QTTR4CNEQARAoQ1AJ42ItHkJ37eFUY8rSoGpN/dVoKIFACeJi7b
KW6/pzn8VEKi3hO0Gqomsms=
=cSQh
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Ciaran McCreesh
On Thu, 03 Nov 2005 19:29:45 -0500 Nathan L. Adams [EMAIL PROTECTED]
wrote:
| Flat files can be great in certain situations. Flat files do indeed
| make the parsing trivial. However SIMPLE CODE ISN'T ALWAYS THE MOST
| IMPORTANT REQUIREMENT. In the case of this GLEP, the most important
| requirement is getting the proper migration info to the users in the
| best possible way.

Read the list of requirements in the GLEP. The plain text solution
meets all of them. XML fails on several.

And, incidentally, I came up with the requirements list *before*
dismissing XML.

| So what are the trade-offs of the 'flat file'? If you store a
| migration guide as a 'flat file', its not going to be very readable.

Who said anything about storing a migration guide as a flat file? Read
the GLEP.

| GuideXML is the standard for Gentoo docs for some damn good reasons!

No, it's the standard because Daniel said so. And the reasons behind
which web publishing setup we use have little relation to good reasons
for a news delivery system.

Why do you think we still send email in plain text?

*shrug* Anyway, if you want to come up with an alternate GLEP based
around XML, bittorrent, Java and CORBA, go right ahead. The GLEP system
is quite happy with handling multiple competing proposals for a given
topic, and at the end of it we can select the best proposal, reject all
the proposals or go and come up with a new proposal with bits from
both.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpqfy2av9otm.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Ciaran McCreesh wrote:
 On Tue, 1 Nov 2005 14:32:47 +0100 Jakub Moc [EMAIL PROTECTED] wrote:
 | What do you mean they aren't tied to ebuilds? I don't really
 | understand what this feature should do then, it seems. Once again,
 | what's wrong with reusing emerge --changelog mechanism for displaying
 | this kind of information?
 
 We make changes that have scope other than ebuilds.
 
 | I'm not particularly happy with idea of emerge as a newsreader
 | really, IMHO we should display relevant, vital upgrading information
 | *when relevant*, not to inform users about upgrades that they are not
 | interested in in the least.
 
 Which is what my proposed GLEP does, at least as far as we can
 determine automatically. Yes, occasionally this will mean giving, say,
 mysql 4.1 upgrade instructions to people who plan to use only mysql
 4.0, but then, if we didn't give them the news, most of them wouldn't
 know that they don't want to upgrade.
 
 And it doesn't turn emerge into a news reader. All portage does is
 deliver the news. How said news is read is a different issue.
 
 | And please, keep the thing simple so that I can be done in reasonable
 | amount of time and does not follow the destiny of einfo/ewarn logging
 | (3 years and counting).
 
 Of course. Hence why I'm proposing something easy and workable, and not
 suggesting some magic new framework that will solve all existing
 problems (including world peace).
 

Just keep in mind that portage is supposed to be non-interactive and
most users like it that way. (Although the countdown when cleaning out
old packages kinda breaks that idea, but I digress.)

So just make sure that the scheme doesn't involve forcing the user to
notice anything during a 'normal' non-interactive emerge in order for it
to be effective. Thats why I keep pushing having a nice GuideXML version
in a central location like http://errata.g.o/ and just having emerge
output a summary and a link (however/at what point/with what mechanism
you decide to actually have portage output it).
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDaq8U2QTTR4CNEQARAm6kAJ948WBp0elnZvxoHLMXvNfaBZvxsgCdEdAO
gO6VPobgKHfqcKpjAQ1II6U=
=iNoA
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Ciaran McCreesh
On Thu, 03 Nov 2005 19:45:08 -0500 Nathan L. Adams [EMAIL PROTECTED]
wrote:
| Just keep in mind that portage is supposed to be non-interactive and
| most users like it that way. (Although the countdown when cleaning out
| old packages kinda breaks that idea, but I digress.)

You really should give the GLEP a read. It's quite nice, you know...

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpj8ofRTUpbd.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Chris Gianelloni wrote:
 On Tue, 2005-11-01 at 12:26 +, Ciaran McCreesh wrote:
 
On Tue, 01 Nov 2005 13:16:03 +0100 Thierry Carrez [EMAIL PROTECTED]
wrote:
| For them to know about it, they need to be warned when they do their
| emerge -p world or emerge -a mysql that the upgrade is not as easy
| as it seems. People using a cron job to sync are probably a
| significant part of our user base...

Have Portage give a red flashy before emerge if there're unread news
items?
 
 Or have it die unless they have
 I_LIKE_A_BROKEN_SYSTEM_PLEASE_IGNORE_NEWS=yes in make.conf ;]
 
Although, a better solution for users who cron sync would be to have
said cron mail them all the relevant news files...
 
 We don't have control over what they do in cron, we do have control over
 portage itself.
 

The cron thing is a *really* good idea. Its so good that its an example
in the Gentoo Cron How-to. A few developers actively debugging the sync
process might enjoy watching the output of a sync scroll by, but
normal/sane people have better things to do. (Note: I'm not bashing
Chris's statement here; I honestly don't know what point he was trying
to make).

So don't implement the --news thing in such a way that in the future a
developer might be tempted to tell a complaining user whats the matter
with you? don't you read the output when you sync? no? what a loser; no
wonder your system is b0rked. (or something to that effect)
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDarFQ2QTTR4CNEQARAgWDAJ0cW1xpOKCy+jjaYCoGBbfOOXSGwwCgojNk
flBm0MnXXXRLsBGC3XXcYts=
=1Ls9
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Ciaran McCreesh wrote:
 On Thu, 03 Nov 2005 19:29:45 -0500 Nathan L. Adams [EMAIL PROTECTED]
 wrote:
 | Flat files can be great in certain situations. Flat files do indeed
 | make the parsing trivial. However SIMPLE CODE ISN'T ALWAYS THE MOST
 | IMPORTANT REQUIREMENT. In the case of this GLEP, the most important
 | requirement is getting the proper migration info to the users in the
 | best possible way.
 
 Read the list of requirements in the GLEP. The plain text solution
 meets all of them. XML fails on several.

If readability isn't a requirement, your list is wrong.

 And, incidentally, I came up with the requirements list *before*
 dismissing XML.

Given your past public statement about XML; I highly doubt that. Whether
you were concious of it or not, I suspect that XML bashing was always in
the mix.

 | So what are the trade-offs of the 'flat file'? If you store a
 | migration guide as a 'flat file', its not going to be very readable.
 
 Who said anything about storing a migration guide as a flat file? Read
 the GLEP.

No, *you* need to read my previous response. I was using 'flat file' to
mean whatever it is you're calling your less-than-GuideXML scheme.

 | GuideXML is the standard for Gentoo docs for some damn good reasons!
 
 No, it's the standard because Daniel said so. And the reasons behind
 which web publishing setup we use have little relation to good reasons
 for a news delivery system.
 
 Why do you think we still send email in plain text?

Why do you think news is sent as an RSS feed? Answer: Because it has
proven to be the best way!

 *shrug* Anyway, if you want to come up with an alternate GLEP based
 around XML, bittorrent, Java and CORBA, go right ahead.

I never mentioned bittorrent, Java, or CORBA. If you don't have a valid
arguement, please don't try to distract everyone by putting words into
the mouths of those you're arguing with.

 The GLEP system
 is quite happy with handling multiple competing proposals for a given
 topic, and at the end of it we can select the best proposal, reject all
 the proposals or go and come up with a new proposal with bits from
 both.

So if you didn't want people to actually review and comment on *your*
GLEP, why did you write:

The attached GLEP is a draft proposal for the emerge --news thing
that's been under discussion. There are still some TODO items. These are
calls for people to weigh in with suggestions. Of course, suggestions on
other items are good too...
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDarNC2QTTR4CNEQARAkvgAJ91X9MQyPVLE20VPYhAVq5O36jV3gCeI/nY
swzdhW0+/C84vVN9UQ8aes4=
=DiXn
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Ciaran McCreesh wrote:
 On Thu, 03 Nov 2005 19:45:08 -0500 Nathan L. Adams [EMAIL PROTECTED]
 wrote:
 | Just keep in mind that portage is supposed to be non-interactive and
 | most users like it that way. (Although the countdown when cleaning out
 | old packages kinda breaks that idea, but I digress.)
 
 You really should give the GLEP a read. It's quite nice, you know...
 

Your explanations hint at interacting with portage during an emerge.
Specifically you floated the idea of having emerge print a red flashy
message before doing the emerge. *That* is what I was commenting on.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDarPp2QTTR4CNEQARAkkbAKCn8yDt7D17Ls+/huZkg4TkKjmXVwCgntbs
BrrWIziJCF2M8RckaINyMNA=
=Ytle
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Ciaran McCreesh
On Thu, 03 Nov 2005 20:02:58 -0500 Nathan L. Adams [EMAIL PROTECTED]
wrote:
| So if you didn't want people to actually review and comment on *your*
| GLEP, why did you write:
| 
| The attached GLEP is a draft proposal for the emerge --news thing
| that's been under discussion. There are still some TODO items. These
| are calls for people to weigh in with suggestions. Of course,
| suggestions on other items are good too...

I want people to review and comment on it after they've actually read
the thing.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpCFBr3xb18d.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Ciaran McCreesh
On Thu, 03 Nov 2005 20:05:45 -0500 Nathan L. Adams [EMAIL PROTECTED]
wrote:
| Ciaran McCreesh wrote:
|  On Thu, 03 Nov 2005 19:45:08 -0500 Nathan L. Adams
|  [EMAIL PROTECTED]
|  wrote:
|  | Just keep in mind that portage is supposed to be non-interactive
|  | and most users like it that way. (Although the countdown when
|  | cleaning out old packages kinda breaks that idea, but I digress.)
|  
|  You really should give the GLEP a read. It's quite nice, you know...
|  
| 
| Your explanations hint at interacting with portage during an emerge.
| Specifically you floated the idea of having emerge print a red flashy
| message before doing the emerge. *That* is what I was commenting on.

Ever noticed any of the other red flashies that emerge gives? For
example, if you try emerge -C glibc? Doesn't break the non-interactive
requirement, it's just yet another way of shoving something in the
user's face if they somehow ignore all the normal warnings.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpdhBQefUasn.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Ciaran McCreesh wrote:
 On Thu, 03 Nov 2005 20:02:58 -0500 Nathan L. Adams [EMAIL PROTECTED]
 wrote:
 | So if you didn't want people to actually review and comment on *your*
 | GLEP, why did you write:
 | 
 | The attached GLEP is a draft proposal for the emerge --news thing
 | that's been under discussion. There are still some TODO items. These
 | are calls for people to weigh in with suggestions. Of course,
 | suggestions on other items are good too...
 
 I want people to review and comment on it after they've actually read
 the thing.
 

I have read it, and I find it lacking; thus the comments. Or are you
claiming that the idea of having a central website like errata.g.o with
GuideXML-ized migrations guides is in your GLEP? Its not. I'm proposing
adding that as the definative source of the errata, and feeding it to
other places (emerge --news, mailing lists, forums, GWN) as desired.

I'm also commenting on the part that *wrongly* states It is not
reasonable to expect all users to have an MTA, *web browser*, email
client, cron daemon or text processing suite available on their system.
In particular, this means that any markup to be parsed must be in a very
simple format.

*ALL* of the official docs are GuideXML; Gentoo *expects* users to have
a web browser by default. Otherwise a vast majority of users would never
get Gentoo installed in the first place. The lightweight requirement
appears to just be your way of subverting the current documentation
standards (because of your XML hatred).

The news directory shouldn't the main source of the migration guides;
the website should be (one central page that can feed other sources).
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDarhL2QTTR4CNEQARAr+KAJ9v5iy+i5tvqNx9woib/cJUZI+eMwCgohIo
acuUUmVYcI1TsBDX0dg/K0s=
=bWEF
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Ciaran McCreesh wrote:
 On Thu, 03 Nov 2005 20:05:45 -0500 Nathan L. Adams [EMAIL PROTECTED]
 wrote:
 | Ciaran McCreesh wrote:
 |  On Thu, 03 Nov 2005 19:45:08 -0500 Nathan L. Adams
 |  [EMAIL PROTECTED]
 |  wrote:
 |  | Just keep in mind that portage is supposed to be non-interactive
 |  | and most users like it that way. (Although the countdown when
 |  | cleaning out old packages kinda breaks that idea, but I digress.)
 |  
 |  You really should give the GLEP a read. It's quite nice, you know...
 |  
 | 
 | Your explanations hint at interacting with portage during an emerge.
 | Specifically you floated the idea of having emerge print a red flashy
 | message before doing the emerge. *That* is what I was commenting on.
 
 Ever noticed any of the other red flashies that emerge gives? For
 example, if you try emerge -C glibc? Doesn't break the non-interactive
 requirement, it's just yet another way of shoving something in the
 user's face if they somehow ignore all the normal warnings.
 

Yes, I've noticed them. My point is that you need to be careful that the
red-flashy doesn't the primary way of delivering the message.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDarid2QTTR4CNEQARAq+gAKCZ0e1kZHeuYvQcjqxKwTZ+XsbXRACgh2ef
gSZ1q0Of1t6SA6u5oMQkp5c=
=oKCA
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Ciaran McCreesh
On Thu, 03 Nov 2005 20:24:27 -0500 Nathan L. Adams [EMAIL PROTECTED]
wrote:
| I'm also commenting on the part that *wrongly* states It is not
| reasonable to expect all users to have an MTA, *web browser*, email
| client, cron daemon or text processing suite available on their
| system. In particular, this means that any markup to be parsed must
| be in a very simple format.
| 
| *ALL* of the official docs are GuideXML; Gentoo *expects* users to
| have a web browser by default. Otherwise a vast majority of users
| would never get Gentoo installed in the first place. The
| lightweight requirement appears to just be your way of subverting
| the current documentation standards (because of your XML hatred).

I don't have a web browser installed on my server. Do you?

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpThKJvameCK.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Brian Harring
On Thu, Nov 03, 2005 at 08:24:27PM -0500, Nathan L. Adams wrote:
 I'm also commenting on the part that *wrongly* states It is not
 reasonable to expect all users to have an MTA, *web browser*, email
 client, cron daemon or text processing suite available on their system.
 In particular, this means that any markup to be parsed must be in a very
 simple format.
 
 *ALL* of the official docs are GuideXML; Gentoo *expects* users to have
 a web browser by default. Otherwise a vast majority of users would never
 get Gentoo installed in the first place. The lightweight requirement
 appears to just be your way of subverting the current documentation
 standards (because of your XML hatred).

We actually have links in the base profile iirc, either way, the 
example of where this breaks down is headless servers...

 The news directory shouldn't the main source of the migration guides;
 the website should be (one central page that can feed other sources).
Not necessarily the website imo, some central store where it's pushed 
out to all of the locations though (which I suspect you're getting 
at).
~harring


pgpQZBR7QbbP5.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Ciaran McCreesh wrote:
 On Thu, 03 Nov 2005 20:24:27 -0500 Nathan L. Adams [EMAIL PROTECTED]
 wrote:
 | I'm also commenting on the part that *wrongly* states It is not
 | reasonable to expect all users to have an MTA, *web browser*, email
 | client, cron daemon or text processing suite available on their
 | system. In particular, this means that any markup to be parsed must
 | be in a very simple format.
 | 
 | *ALL* of the official docs are GuideXML; Gentoo *expects* users to
 | have a web browser by default. Otherwise a vast majority of users
 | would never get Gentoo installed in the first place. The
 | lightweight requirement appears to just be your way of subverting
 | the current documentation standards (because of your XML hatred).
 
 I don't have a web browser installed on my server. Do you?
 

So you installed your server without reading *any* documenation? (Don't
lie). And you expect that the average user installs a Gentoo server
without at least referencing the documentation? Pa-leaze.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDarsD2QTTR4CNEQARAuZhAJ49FHBjVbDQbC6+nyBIw6wRjLZE+QCeO/yW
dPY2A20OJcwJ/NTOwZqg434=
=SPIh
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Stephen P. Becker

*ALL* of the official docs are GuideXML; Gentoo *expects* users to have
a web browser by default. Otherwise a vast majority of users would never
get Gentoo installed in the first place. The lightweight requirement
appears to just be your way of subverting the current documentation
standards (because of your XML hatred).


How about getting some facts straight before running your mouth?  Gentoo 
most certainly does not expect users to have a web browser to install. 
The last time I actually installed on x86 (which was some time ago 
admittedly), there was a .txt version of the install guide on the livecd.


Even then, the web browser you are speaking of runs directly off the 
livecd.  So, what happens when there is critical news to be read during 
the install phase inside the chroot, but no web browser is yet 
installed?  Are you suggesting we bloat stage1 and stage2 with some sort 
of XML parser so that the user can read news without having to kill the 
emerge and read the news outside the chroot?  I think you would have a 
seriously hard time convincing the release folks this is a good idea.


Furthermore, it is not possible to include any sort of XML parser with 
installers for certain arches which use very minimal netboots for the 
default installation method.  So really, your complaints about the 
lightweight requirement appears to just be a way of subverting 
attention away from the real reasons it is a good idea, and towards 
maintaining a flamewar with ciaran that you will surely lose.


-Steve

--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Brian Harring wrote:
 Not necessarily the website imo, some central store where it's pushed 
 out to all of the locations though (which I suspect you're getting 
 at).

I forgot to clarify one point. I'm saying that http://errata.g.o/ should
be the *official* source where users go to find the info, not
neccessarity the place where the raw data is stored and pushed to other
places (although it certainly could be).
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDarzS2QTTR4CNEQARAlB7AJsHfqCVL160KApWZU7iuqNtCb9SWwCcCtRR
D2e1H1U208kQQNzLDo9CpGk=
=kiyo
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Stephen P. Becker



So you installed your server without reading *any* documenation? (Don't
lie). And you expect that the average user installs a Gentoo server
without at least referencing the documentation? Pa-leaze.


Funny, I've done three fresh installs on my various mips machines in the 
past couple of weeks, and I didn't read even a word of documentation to 
do it.


Besides, if somebody is installing gentoo on a server, do you really 
think that would be their only box?  Surely they have a workstation of 
some sort, since a proper server certainly would not be also used as a 
desktop.


-Steve

--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Ciaran McCreesh
On Thu, 03 Nov 2005 20:36:03 -0500 Nathan L. Adams [EMAIL PROTECTED]
wrote:
| So you installed your server without reading *any* documenation?

Actually, yes, I did. I can quite easily do installs without the
documentation, as can most other people who really know how Gentoo
works.

| (Don't lie). And you expect that the average user installs a Gentoo
| server without at least referencing the documentation? Pa-leaze.

I bet there're lots of people who don't read the documentation using
the machine on which they're installing.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpSUud7EleCU.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Ciaran McCreesh
On Thu, 03 Nov 2005 20:41:36 -0500 Nathan L. Adams [EMAIL PROTECTED]
wrote:
| If I understand his position correctly, Ciaran doesn't want the
| GuideXML version at all, which is a supremely stupid idea IMHO.

Read GLEP. GLEP good.

Especially the bit about interoperability with existing news sources.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgprpwi22W4JW.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Lance Albertson
Nathan L. Adams wrote:

 *ALL* of the official docs are GuideXML; Gentoo *expects* users to have
 a web browser by default. Otherwise a vast majority of users would never
 get Gentoo installed in the first place. The lightweight requirement
 appears to just be your way of subverting the current documentation
 standards (because of your XML hatred).

Since when did GuideXML become the standard for all our websites?
Currently, the only website that uses it is www. Nothing else uses it.
If any solution to the errata site idea is going to come out, it doesn't
need to be guidexml, it can be anything.

After reading through the heated thread, I have yet to see your valid
point of pushing xml for such a simple task. All I have seen is two 3rd
grade kids arguing over a swing set. Please give some calm reasons for
your opinion instead of voicing things in such a heated manner. Making
assumptions about someone else's opinions gets you no where.

Please keep your discussion to this thread a discussion and not an
argument between you and ciaranm. Please take those off this list.

Cheers-

-- 
Lance Albertson [EMAIL PROTECTED]
Gentoo Infrastructure | Operations Manager

---
GPG Public Key:  http://www.ramereth.net/lance.asc
Key fingerprint: 0423 92F3 544A 1282 5AB1  4D07 416F A15D 27F4 B742

ramereth/irc.freenode.net


signature.asc
Description: OpenPGP digital signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Stephen P. Becker wrote:
 *ALL* of the official docs are GuideXML; Gentoo *expects* users to have
 a web browser by default. Otherwise a vast majority of users would never
 get Gentoo installed in the first place. The lightweight requirement
 appears to just be your way of subverting the current documentation
 standards (because of your XML hatred).
 
 
 How about getting some facts straight before running your mouth?  Gentoo
 most certainly does not expect users to have a web browser to install.
 The last time I actually installed on x86 (which was some time ago
 admittedly), there was a .txt version of the install guide on the livecd.
 
 Even then, the web browser you are speaking of runs directly off the
 livecd.  So, what happens when there is critical news to be read during
 the install phase inside the chroot, but no web browser is yet
 installed?  Are you suggesting we bloat stage1 and stage2 with some sort
 of XML parser so that the user can read news without having to kill the
 emerge and read the news outside the chroot?  I think you would have a
 seriously hard time convincing the release folks this is a good idea.
 
 Furthermore, it is not possible to include any sort of XML parser with
 installers for certain arches which use very minimal netboots for the
 default installation method.  So really, your complaints about the
 lightweight requirement appears to just be a way of subverting
 attention away from the real reasons it is a good idea, and towards
 maintaining a flamewar with ciaran that you will surely lose.


Let me say it one more time. I'm not saying you have to have a web
browser installed on the system that you are updating or installing. I'm
saying that the GuideXML docs are the standard, official source of
documentation and the same should hold true for the migration guides.
I'm also saying that feedback from users said they want ONE official
place to find this stuff. Therefor any plan that doesn't take both of
those things into account is silly. And having the GuideXML-ized guides
on a central website marked as the 'official-one-stop-for-errata' does
not in any way shape or form preclude anyone from mirroring that info in
a text file, forum post, emerge --news, mailing list, etc. etc. ad nauseum.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDar7y2QTTR4CNEQARAkK2AJ9W+uofXxiuNc86gzsfHISvD7XkPgCeMeue
kDgucVFWYYLAb74WbcLQWpM=
=6A4p
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Stephen P. Becker wrote:
 
 So you installed your server without reading *any* documenation? (Don't
 lie). And you expect that the average user installs a Gentoo server
 without at least referencing the documentation? Pa-leaze.
 
 
 Funny, I've done three fresh installs on my various mips machines in the
 past couple of weeks, and I didn't read even a word of documentation to
 do it.
 
 Besides, if somebody is installing gentoo on a server, do you really
 think that would be their only box?  Surely they have a workstation of
 some sort, since a proper server certainly would not be also used as a
 desktop.

And therefore they would have a access to a web browser. Thank you for
helping to explain my point.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDar8m2QTTR4CNEQARAvlAAJ9cXIqGHzojBSkz6XEACuXefbBE1ACaAsE2
p2wxad72pF3iHPAf+LU2x7s=
=z0nr
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Ciaran McCreesh wrote:
 On Thu, 03 Nov 2005 20:36:03 -0500 Nathan L. Adams [EMAIL PROTECTED]
 wrote:
 | So you installed your server without reading *any* documenation?
 
 Actually, yes, I did. I can quite easily do installs without the
 documentation, as can most other people who really know how Gentoo
 works.

And as a long time developer, I'm sure you represent the typical user...

 | (Don't lie). And you expect that the average user installs a Gentoo
 | server without at least referencing the documentation? Pa-leaze.
 
 I bet there're lots of people who don't read the documentation using
 the machine on which they're installing.

See above.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDar+G2QTTR4CNEQARAqTdAJ9LT4bx+nrPJpdwpttZaKFoOCVTSgCfYbvy
ozqoUGfbXM57FLxBMYp9UWg=
=Alrz
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Grant Goodyear
Nathan L. Adams wrote: [Thu Nov 03 2005, 07:02:58PM CST]
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1
 
 Ciaran McCreesh wrote:
  Read the list of requirements in the GLEP. The plain text solution
  meets all of them. XML fails on several.
 
 If readability isn't a requirement, your list is wrong.

I would argue that reading raw xml is a lot less fun than reading minimally
marked-up plain text (such as an e-mail).

  | So what are the trade-offs of the 'flat file'? If you store a
  | migration guide as a 'flat file', its not going to be very readable.
  
  Who said anything about storing a migration guide as a flat file? Read
  the GLEP.
 
 No, *you* need to read my previous response. I was using 'flat file' to
 mean whatever it is you're calling your less-than-GuideXML scheme.

*Sigh*  I think you might be misinterpreting the GLEP.  The news items
are likely to be fairly short, such as the YourSQL example that's in
the GLEP.  The news item would then point to a migration guide that
resides elsewhere, if needed.

The point behind having the news pulled by portage is that the headless
server, for example,  would only report news items that are relevant to
that machine.  The server's admin could then fire up a web browser on a
desktop machine to read any necessary additional info.

  | GuideXML is the standard for Gentoo docs for some damn good reasons!

True, but at the same time there's a reason that GLEPs can be written in
restructured text as well as guidexml.  I doubt that it's accidental
that almost all GLEPs have been submitted in restructured text rather
than guidexml.  (Incidentally, I like our guidexml.  I think that it
renders quite well for what we want.  I'm not so fond of writing it,
however.)

That's really beside the point, though.  The real point is that plain
text news items are going to be the easiest to create and the easiest to
read on a console screen.

As for having an errata page, it wouldn't be difficult to write a
program to automatically convert news items to guidexml.  I suspect that
ciaranm could even be talked into writing it, if such a page were to
become reality.

-g2boojum-
-- 
Grant Goodyear  
Gentoo Developer
[EMAIL PROTECTED]
http://www.gentoo.org/~g2boojum
GPG Fingerprint: D706 9802 1663 DEF5 81B0  9573 A6DC 7152 E0F6 5B76


pgppllN4FWKVp.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Lance Albertson
Grant Goodyear wrote:

| GuideXML is the standard for Gentoo docs for some damn good reasons!
 
 
 True, but at the same time there's a reason that GLEPs can be written in
 restructured text as well as guidexml.  I doubt that it's accidental
 that almost all GLEPs have been submitted in restructured text rather
 than guidexml.  (Incidentally, I like our guidexml.  I think that it
 renders quite well for what we want.  I'm not so fond of writing it,
 however.)

Here here ... I like how GLEPs are primarily in RST format which is
really easy to read in raw form. My vote/opinion is to use a similar
format for news items which I'm pretty sure can be easily converted to
whatever format we end up using (GuideXML or not) for the site portion
of this GLEP.

Cheers-

-- 
Lance Albertson [EMAIL PROTECTED]
Gentoo Infrastructure | Operations Manager

---
GPG Public Key:  http://www.ramereth.net/lance.asc
Key fingerprint: 0423 92F3 544A 1282 5AB1  4D07 416F A15D 27F4 B742

ramereth/irc.freenode.net


signature.asc
Description: OpenPGP digital signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Luis F. Araujo

Nathan L. Adams wrote:


-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Stephen P. Becker wrote:
 


So you installed your server without reading *any* documenation? (Don't
lie). And you expect that the average user installs a Gentoo server
without at least referencing the documentation? Pa-leaze.
 


Funny, I've done three fresh installs on my various mips machines in the
past couple of weeks, and I didn't read even a word of documentation to
do it.

Besides, if somebody is installing gentoo on a server, do you really
think that would be their only box?  Surely they have a workstation of
some sort, since a proper server certainly would not be also used as a
desktop.
   



And therefore they would have a access to a web browser. Thank you for
helping to explain my point.
 

The point is not about havig access to a web browser, but to have it 
installed

in the respective box reading news.
--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Qian Qiao
On 11/4/05, Nathan L. Adams [EMAIL PROTECTED] wrote:
 And as a long time developer, I'm sure you represent the typical user...

Well, I'm a normal user here, and I can install gentoo quite easily
without reading the documentation. it's dead simple:
prepare the disks - get the stage tarballs - chroot -
bootstrap/emerge -e system - build the kernel - build the bootloader
- a few config tweaks.

Onces one gets the idea, i don't see how a gentoo installation is
harder than a RH or debian or suse one.

-- Joe

--
There are 3 kinds of people in the world:
Those who can count, and those who can't.

-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Lance Albertson wrote:
 Nathan L. Adams wrote:
 
 
*ALL* of the official docs are GuideXML; Gentoo *expects* users to have
a web browser by default. Otherwise a vast majority of users would never
get Gentoo installed in the first place. The lightweight requirement
appears to just be your way of subverting the current documentation
standards (because of your XML hatred).
 
 
 Since when did GuideXML become the standard for all our websites?
 Currently, the only website that uses it is www. Nothing else uses it.
 If any solution to the errata site idea is going to come out, it doesn't
 need to be guidexml, it can be anything.

http://www.gentoo.org/proj/en/gdp/doc/doc-policy.xml#doc_chap3

However, when the document is finished, it should be transformed into
GuideXML and made available on the Gentoo CVS infrastructure. It must
also be registered in the metadoc.xml file if applicable.

I never said all [Gentoo] website; just documentation. Errata is
documentation.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDavH02QTTR4CNEQARAryaAJkB4DCRYSxwrskI20hzqkC7nmcmggCgpkUu
TaEAOVda9tjLj1CQZK1YIkg=
=FO5/
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-03 Thread Nathan L. Adams
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Grant Goodyear wrote:
 Nathan L. Adams wrote: [Thu Nov 03 2005, 07:02:58PM CST]
 
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Ciaran McCreesh wrote:

Read the list of requirements in the GLEP. The plain text solution
meets all of them. XML fails on several.

If readability isn't a requirement, your list is wrong.
 
 
 I would argue that reading raw xml is a lot less fun than reading minimally
 marked-up plain text (such as an e-mail).

Oh good grief! Nobody is arguing that the user should have to read raw XML.

 
| So what are the trade-offs of the 'flat file'? If you store a
| migration guide as a 'flat file', its not going to be very readable.

Who said anything about storing a migration guide as a flat file? Read
the GLEP.

No, *you* need to read my previous response. I was using 'flat file' to
mean whatever it is you're calling your less-than-GuideXML scheme.
 
 *Sigh*  I think you might be misinterpreting the GLEP.  The news items
 are likely to be fairly short, such as the YourSQL example that's in
 the GLEP.  The news item would then point to a migration guide that
 resides elsewhere, if needed.

No, I happen to understand the that point. Emerge outputting a short
summary is great. But the GLEP should cover the hey mr. end user, the
central repository for errata/full fledged migration guides is here:
[insert url] as well.

 
 The point behind having the news pulled by portage is that the headless
 server, for example,  would only report news items that are relevant to
 that machine.  The server's admin could then fire up a web browser on a
 desktop machine to read any necessary additional info.

Great; I'm not against that. Now where does that admin point her web
browser? Mailing list archive? GWN archive? The Forums? The stated
feedback is that users what a central place for the errata (whether the
errata be large or small).

 
| GuideXML is the standard for Gentoo docs for some damn good reasons!
 
 
 True, but at the same time there's a reason that GLEPs can be written in
 restructured text as well as guidexml.  I doubt that it's accidental
 that almost all GLEPs have been submitted in restructured text rather
 than guidexml.  (Incidentally, I like our guidexml.  I think that it
 renders quite well for what we want.  I'm not so fond of writing it,
 however.)
 
 That's really beside the point, though.  The real point is that plain
 text news items are going to be the easiest to create and the easiest to
 read on a console screen.
 
 As for having an errata page, it wouldn't be difficult to write a
 program to automatically convert news items to guidexml.  I suspect that
 ciaranm could even be talked into writing it, if such a page were to
 become reality.

I happen to think that the assumption that the errata are going to be
small is a bad one. I think if errata is neccessary in the first place
then its going to be something larger than a screen's worth of console
output and worth the supposed trouble of GuideXML. So why not approach
it from the GuideXML end first, and extract the summary from that?
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDavVI2QTTR4CNEQARAnMnAKCAir22mvnCgoKXc8xPDIYaQMmReACdELKr
aa1l8avqCC7nIvV/VypyJj8=
=LxgP
-END PGP SIGNATURE-
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-02 Thread Michiel de Bruijne
On Wednesday 02 November 2005 02:29, Brian Harring wrote:
 On Tue, Nov 01, 2005 at 10:16:35PM +, Ciaran McCreesh wrote:

  | How will it handle GLSAs then? [1]
 
  gentoolkit != portage.

 Correct.  Course, also incorrect.

A plan for handling GLSA's from portage (emerge --security) was announced some 
time ago. Is this still planned (i.o.w. portage handling xml)?
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-02 Thread Chris Gianelloni
On Tue, 2005-11-01 at 19:29 -0600, Brian Harring wrote:
 We already have a module for parsing metadata.xml in use in the 
 experimental 2.1 branch (which can be backported to 2.0 if anyone 
 wants it and does the work).
 
 Python comes bundled with xml as long as you don't have the build flag 
 enabled.

Translation: it won't work on a stage1 tarball, but will work any time
after bootstrap.  ;]

-- 
Chris Gianelloni
Release Engineering - Strategic Lead
x86 Architecture Team
Games - Developer
Gentoo Linux


signature.asc
Description: This is a digitally signed message part


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-02 Thread Jan Kundrát
On Tuesday 01 of November 2005 23:16 Ciaran McCreesh wrote:
 | How will it handle GLSAs then? [1]

 gentoolkit != portage.

To quote GLEP 14 [1]:

Once this tool is implemented and well tested it can be integrated into 
portage.

 |  It's not a question of what's wrong with XML?. It's a question of
 |  what advantage would we gain by strapping a giant flapping wet
 |  kipper to a bicycle?.
 |
 | Or (a little bit rephrased) why should we stick with consistent file
 | formats.

 Uh, you'd have to invent a load of new XML DTD stuff for this anyway.

Nope. We can build on *existing* GLSA DTD and on *existing* code. The downside 
is that Portage integration could be slower (same case as with `glsa-check`, 
AFAIK).

 So you're not using a consistent file format at all, you're just using
 a consistent unnecessary layer in the middle, which as a side effect
 makes your files incompatible with every standard Unix tool ever
 written.

See below.

 Using XML does not magically make things compatible. XML is just a
 layer in the middle. Any tool processing XML files still has to worry
 about however the DTD in question works.

Just to clarify - I don't say that XML is The Best Way To Go (tm), I'm just 
pointing out another possibility of implementation which is *very* similar to 
the way GLSAs are processed. 

GLSA already contains stuff for marking items as valid only for given systems, 
for injecting them etc. Why don't use existing code? Why duplication?

Have a look at the XML source of any GLSA.

 You think XML magically makes things compatible? Then I suggest you
 write a GuieXML to Docbook conversion tool, and see how many thousand
 lines of XSLT it takes. All XML does is move the conversion and parsing
 problems to a different, more complex level.

I'm not familiar with DocBook, but I doubt I'll need thousands of lines of 
code.

[1] http://www.gentoo.org/proj/en/glep/glep-0014.html

WKR,
-jkt

-- 
cd /local/pub  more beer  /dev/mouth


pgpjwA8sWa0OI.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-02 Thread Eldad Zack
On Tuesday 01 November 2005 14:39, Jakub Moc wrote:
 1.11.2005, 13:26:57, Ciaran McCreesh wrote:
  On Tue, 01 Nov 2005 13:16:03 +0100 Thierry Carrez [EMAIL PROTECTED]
 
  wrote:
  | For them to know about it, they need to be warned when they do their
  | emerge -p world or emerge -a mysql that the upgrade is not as easy
  | as it seems. People using a cron job to sync are probably a
  | significant part of our user base...
 
  Have Portage give a red flashy before emerge if there're unread news
  items?
 
  Although, a better solution for users who cron sync would be to have
  said cron mail them all the relevant news files...

 Uhm... emerge sync is a *bad* time to display upgrade messages, it's simply
 irrelevant at that time, I'm not upgrading anything at the moment and might
 not be upgrading for next week or so.

 The messages should be displayed when I'm about to upgrade an ebuild which
 has an upgrade note associated with the new version. Sending mail via cron
 might be a nice optional feature for those who want to use it.

I think cron as suggested hit the spot here. I do the same with glsa-check -t 
all to notify me about security issues present on my system.



-- 
Eldad Zack [EMAIL PROTECTED]
Key/Fingerprint at pgp.mit.edu, ID 0x96EA0A93


pgp2wxzQheG8t.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-02 Thread Ciaran McCreesh
On Wed, 2 Nov 2005 19:33:37 +0100 Jan Kundrát [EMAIL PROTECTED] wrote:
| Once this tool is implemented and well tested it can be integrated
| into portage.

can ! will. It might, but don't count on it.

| GLSA already contains stuff for marking items as valid only for given
| systems, for injecting them etc. Why don't use existing code? Why
| duplication?

Because it's quicker to invent a wheel which is actually round.

|  You think XML magically makes things compatible? Then I suggest you
|  write a GuieXML to Docbook conversion tool, and see how many
|  thousand lines of XSLT it takes. All XML does is move the
|  conversion and parsing problems to a different, more complex level.
| 
| I'm not familiar with DocBook, but I doubt I'll need thousands of
| lines of code.

Oh? Our GuideXML to HTML conversion is thousands of lines of code...

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpONiFOejduI.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Wernfried Haas
On Tue, Nov 01, 2005 at 01:51:25AM +, Ciaran McCreesh wrote:
 There is currently no explanation as to why this GLEP should be chosen
 over ChrisWhite's 42. I will add such a section if anyone requests it.
Any reason why you chose bashing Chris' GLEP in another mail and start
your own instead of working together and bringing your input for 42?

 Lightweight
 It is not reasonable to expect all users to have an MTA, web browser,
 email client, cron daemon or text processing suite available on their
 system. In particular, this means that any markup to be parsed must be
 in a very simple format.
I think i have an idea where this is going...
Don't you already have some GLEP saying XML sucks?

I miss references to the old log ewarn issue, which really should be
solved as well while we're at it.

There are some good ideas in your GLEP, so are some in Chris'. No good
is coming from having two similar GLEPs around at the same
time. So please don't waste our time [1] by having two more or less
redundant GLEPs discussed.

cheers,
Wernfried

[1] http://dev.gentoo.org/~chriswhite/flame.html Code listing 1.6


-- 
Wernfried Haas (amne) - amne at gentoo dot org
Gentoo Forums: http://forums.gentoo.org
IRC: #gentoo-forums on freenode - email: forum-mods at gentoo dot org
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread John Myers
On Tuesday 01 November 2005 02:00, Thierry Carrez wrote:
 Ciaran McCreesh wrote:
  Notification that new relevant news items will be displayed via the
  ``emerge`` tool in a similar way to the existing configuration files
  need updating messages:
 
  * Important: 3 config files in /etc need updating.
  * Type emerge --help config to learn how to update config files.
 
  * Important: there are 5 unread news items.
  * Type emerge --help news to learn how to read news files.

 Aren't those messages displayed after the damage is done ? Typical use :

 - emerge --sync run as a daily cron job
 - emerge -a mysql
 - great, a new version is there. Typing Yes
 - system gets borken
 - emerge spits out message saying 14 files need updating and there is 1
 unread news item

 I'm probably missing something here. Please elaborate on how this GLEP
 meets the Preemptive design goal...
The configuration files need updating messages also appear at the end of 
emerge sync

Also, perhaps the news messages could be put at both ends of the emerge 
output?


pgpIbDvAVqFTj.pgp
Description: PGP signature


Re[2]: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Jakub Moc

1.11.2005, 11:00:22, Thierry Carrez wrote:

 Aren't those messages displayed after the damage is done ? Typical use :

 - emerge --sync run as a daily cron job
 - emerge -a mysql
 - great, a new version is there. Typing Yes
 - system gets borken
 - emerge spits out message saying 14 files need updating and there is 1
 unread news item

 I'm probably missing something here. Please elaborate on how this GLEP
 meets the Preemptive design goal...


I'm probably missing something obvious here, because I can't see why *existing*
emerge --changelog code cannot be recycled for this feature to display upgrade
messages when running emerge -uDav world...


-- 
Best regards,

 Jakub Moc
 mailto:[EMAIL PROTECTED]
 GPG signature: http://pgp.mit.edu:11371/pks/lookup?op=getsearch=0xCEBA3D9E
 Primary key fingerprint: D2D7 933C 9BA1 C95B 2C95  B30F 8717 D5FD CEBA 3D9E

 ... still no signature ;)

pgpGyWAZW9tWL.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Ciaran McCreesh
On Tue, 1 Nov 2005 09:25:34 +0100 Wernfried Haas [EMAIL PROTECTED]
wrote:
| On Tue, Nov 01, 2005 at 01:51:25AM +, Ciaran McCreesh wrote:
|  There is currently no explanation as to why this GLEP should be
|  chosen over ChrisWhite's 42. I will add such a section if anyone
|  requests it.
| Any reason why you chose bashing Chris' GLEP in another mail and start
| your own instead of working together and bringing your input for 42?

Yup. I already had most of my GLEP written, and I don't see anything in
ChrisWhite's list of vagueness worth using. Besides, there's nothing
wrong with multiple competing GLEPs on an issue.

| I miss references to the old log ewarn issue, which really should be
| solved as well while we're at it.

Separate concern.

| There are some good ideas in your GLEP, so are some in Chris'. No good
| is coming from having two similar GLEPs around at the same
| time. So please don't waste our time [1] by having two more or less
| redundant GLEPs discussed.

It's my view that ChrisWhite's GLEP is a complete waste of space, given
that it doesn't contain an actual proposal. I see no point in using it.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpFw7VJjtZdT.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Georgi Georgiev
maillog: 01/11/2005-11:45:08(+0100): Jakub Moc types
 1.11.2005, 11:00:22, Thierry Carrez wrote:
 
  Aren't those messages displayed after the damage is done ? Typical use :
 
  - emerge --sync run as a daily cron job
  - emerge -a mysql
  - great, a new version is there. Typing Yes
  - system gets borken
  - emerge spits out message saying 14 files need updating and there is 1
  unread news item
 
  I'm probably missing something here. Please elaborate on how this GLEP
  meets the Preemptive design goal...
 
 
 I'm probably missing something obvious here, because I can't see why 
 *existing*
 emerge --changelog code cannot be recycled for this feature to display upgrade
 messages when running emerge -uDav world...

That reminds me of the idea to stick tags in the ChangeLog:
http://groups.google.com/group/linux.gentoo.dev/msg/8f2dc84619be5c5b?fwc=1

But still, I'm guessing the idea of --news is to tell people that they
need to do something A.S.A.P. This means as soon as the news are
obtained, and the users are nagged about the news on *every invocation
of emerge*, similar to the /etc messages, and not only when they decide
to install some package, which is when --changelog kicks in.

And then, I am not sure why glsa-check cannot do the same job...

-- 
()   Georgi Georgiev   () Computers are unreliable, but humans are   ()
()[EMAIL PROTECTED]() even more unreliable. Any system which ()
() http://www.gg3.net/ () depends on human reliability is()
() --- () unreliable. -- Gilb()


pgp5hGSNJIwjC.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Ciaran McCreesh
On Tue, 01 Nov 2005 13:16:03 +0100 Thierry Carrez [EMAIL PROTECTED]
wrote:
| For them to know about it, they need to be warned when they do their
| emerge -p world or emerge -a mysql that the upgrade is not as easy
| as it seems. People using a cron job to sync are probably a
| significant part of our user base...

Have Portage give a red flashy before emerge if there're unread news
items?

Although, a better solution for users who cron sync would be to have
said cron mail them all the relevant news files...

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpv4SlpznIHh.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Ciaran McCreesh
On Tue, 1 Nov 2005 13:39:24 +0100 Jakub Moc [EMAIL PROTECTED] wrote:
| Uhm... emerge sync is a *bad* time to display upgrade messages, it's
| simply irrelevant at that time, I'm not upgrading anything at the
| moment and might not be upgrading for next week or so.

It doesn't display the messages. It displays a note saying you have
unread news items.

| The messages should be displayed when I'm about to upgrade an ebuild
| which has an upgrade note associated with the new version. Sending
| mail via cron might be a nice optional feature for those who want to
| use it.

Not really a good idea, a) because news items aren't tied directly to
ebuilds, and b) because people like advance warning of when you
upgrade Apache, all hell will break loose! rather than having it
sprung on them suddenly when they're trying to do a quick update.
Getting the news item in advance allows for planning.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpW1XkYvcmx6.pgp
Description: PGP signature


Re[2]: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Jakub Moc

1.11.2005, 13:26:57, Ciaran McCreesh wrote:

 On Tue, 01 Nov 2005 13:16:03 +0100 Thierry Carrez [EMAIL PROTECTED]
 wrote:
 | For them to know about it, they need to be warned when they do their
 | emerge -p world or emerge -a mysql that the upgrade is not as easy
 | as it seems. People using a cron job to sync are probably a
 | significant part of our user base...

 Have Portage give a red flashy before emerge if there're unread news
 items?

 Although, a better solution for users who cron sync would be to have
 said cron mail them all the relevant news files...

Uhm... emerge sync is a *bad* time to display upgrade messages, it's simply
irrelevant at that time, I'm not upgrading anything at the moment and might not
be upgrading for next week or so.

The messages should be displayed when I'm about to upgrade an ebuild which has
an upgrade note associated with the new version. Sending mail via cron might be
a nice optional feature for those who want to use it.

-- 
Best regards,

 Jakub Moc
 mailto:[EMAIL PROTECTED]
 GPG signature: http://pgp.mit.edu:11371/pks/lookup?op=getsearch=0xCEBA3D9E
 Primary key fingerprint: D2D7 933C 9BA1 C95B 2C95  B30F 8717 D5FD CEBA 3D9E

 ... still no signature ;)

pgpt93NCyWMev.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Alec Warner

Ciaran McCreesh wrote:


On Tue, 1 Nov 2005 13:39:24 +0100 Jakub Moc [EMAIL PROTECTED] wrote:
| Uhm... emerge sync is a *bad* time to display upgrade messages, it's
| simply irrelevant at that time, I'm not upgrading anything at the
| moment and might not be upgrading for next week or so.

It doesn't display the messages. It displays a note saying you have
unread news items.

| The messages should be displayed when I'm about to upgrade an ebuild
| which has an upgrade note associated with the new version. Sending
| mail via cron might be a nice optional feature for those who want to
| use it.

Not really a good idea, a) because news items aren't tied directly to
ebuilds, and b) because people like advance warning of when you
upgrade Apache, all hell will break loose! rather than having it
sprung on them suddenly when they're trying to do a quick update.
Getting the news item in advance allows for planning.

 

Personally, I'm for both.  E-mailing cron output is a relatively simple 
operation.  Adding a red flashy deal to emerge saying hey, package X has 
an unread news item, also simple as long as the read/unread format is 
non-complex.  Having emerge --news, I dislike emmensely.  We have emerge 
--changelog, and contrary to what someone posted above, it shows up 
whenever you specify -l.  However changelog does have it's fair share of 
problems, mostly people who don't use the correct changelog format and 
break the tagging, causing -l to display nothing.


If you want to make a seperate program to read the news, go for it.  I 
don't see why we have to stick silly things in a core utility.  emerge 
is a package manager, it does not do your laundry too.


-Alec Warner (Antarus)
--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Ciaran McCreesh
On Tue, 01 Nov 2005 08:34:25 -0500 Alec Warner [EMAIL PROTECTED]
wrote:
| Personally, I'm for both.  E-mailing cron output is a relatively
| simple operation.  Adding a red flashy deal to emerge saying hey,
| package X has an unread news item, also simple as long as the
| read/unread format is non-complex.

Checking for unread news items is just a case of checking for the
existence of files in a particular directory.

| If you want to make a seperate program to read the news, go for it.
| I don't see why we have to stick silly things in a core utility.
| emerge is a package manager, it does not do your laundry too.

Well, I see no reason for Portage itself doing anything beyond basic
news message filtering and installing and alerting that there are
unread news messages.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpsgoMzSNOgn.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Andrej Kacian
On Tue, 1 Nov 2005 01:51:25 +
Ciaran McCreesh [EMAIL PROTECTED] wrote:

 The attached GLEP is a draft proposal for the emerge --news thing that's
 been under discussion. There are still some TODO items. These are calls
 for people to weigh in with suggestions. Of course, suggestions on other
 items are good too...

Before this, make pre-install and post-install emerge messages more usable,
instead of having them lost among thousands of gibberish text in batch emerges.

-- 
Andrej Ticho Kacian ticho at gentoo dot org
Gentoo Linux Developer - net-mail, antivirus, sound, x86


signature.asc
Description: PGP signature


Re[2]: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Jakub Moc

1.11.2005, 13:48:06, Ciaran McCreesh wrote:

 | The messages should be displayed when I'm about to upgrade an ebuild
 | which has an upgrade note associated with the new version. Sending
 | mail via cron might be a nice optional feature for those who want to
 | use it.

 Not really a good idea, a) because news items aren't tied directly to
 ebuilds, and b) because people like advance warning of when you
 upgrade Apache, all hell will break loose! rather than having it
 sprung on them suddenly when they're trying to do a quick update.
 Getting the news item in advance allows for planning.

What do you mean they aren't tied to ebuilds? I don't really understand what
this feature should do then, it seems. Once again, what's wrong with reusing
emerge --changelog mechanism for displaying this kind of information?

I'm not particularly happy with idea of emerge as a newsreader really, IMHO we
should display relevant, vital upgrading information *when relevant*, not to
inform users about upgrades that they are not interested in in the least.
Example: Don't bother me with mysql-4.1 upgrade instructions, I don't plan to
upgrade to that version and did put it into package.mask. Another example:
Don't bother me with upgrade instructions for ~arch ebuilds, I'm running
stable. I want to read them when I decide to upgrade, put them into
package.keywords and run emerge -uav someebuild/world or when it goes stable.

And please, keep the thing simple so that I can be done in reasonable amount of
time and does not follow the destiny of einfo/ewarn logging (3 years and
counting).


-- 
Best regards,

 Jakub Moc
 mailto:[EMAIL PROTECTED]
 GPG signature: http://pgp.mit.edu:11371/pks/lookup?op=getsearch=0xCEBA3D9E
 Primary key fingerprint: D2D7 933C 9BA1 C95B 2C95  B30F 8717 D5FD CEBA 3D9E

 ... still no signature ;)

pgpLvp5ixQ5zP.pgp
Description: PGP signature


Re: Re[2]: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Paul de Vrieze
On Tuesday 01 November 2005 13:39, Jakub Moc wrote:
 Uhm... emerge sync is a *bad* time to display upgrade messages, it's
 simply irrelevant at that time, I'm not upgrading anything at the
 moment and might not be upgrading for next week or so.

If you are not upgrading anything the news is not relevant for you anyway. 
The news is to accompany changes to the tree. 

 The messages should be displayed when I'm about to upgrade an ebuild
 which has an upgrade note associated with the new version. Sending mail
 via cron might be a nice optional feature for those who want to use it.

I agree that it might be usefull to allways declare the related 
package(s). Even when the message is not restricted to them.

Paul

-- 
Paul de Vrieze
Gentoo Developer
Mail: [EMAIL PROTECTED]
Homepage: http://www.devrieze.net


pgp5ri1pptgYX.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Paul de Vrieze
On Tuesday 01 November 2005 02:51, Ciaran McCreesh wrote:
 The attached GLEP is a draft proposal for the emerge --news thing
 that's been under discussion. There are still some TODO items. These
 are calls for people to weigh in with suggestions. Of course,
 suggestions on other items are good too...

 There is currently no explanation as to why this GLEP should be chosen
 over ChrisWhite's 42. I will add such a section if anyone requests it.

 Grant, please pick me a number.


I have one suggestion on an added header. I think that an Overrides: 
header should be added. This is for those messages that make a previous 
message obsolete. Say for example that an upgrade guide to modular X was 
posted, but that a critical error was made in it. This was fixed, and to 
make sure that people read the new message, it is not a higher version.

It is however not a good idea to have people then read the old message 
when the new message is there.

Paul

-- 
Paul de Vrieze
Gentoo Developer
Mail: [EMAIL PROTECTED]
Homepage: http://www.devrieze.net


pgptOkmTozqPt.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Christian Birchinger
On Tue, Nov 01, 2005 at 02:54:51PM +0100, Andrej Kacian wrote:
 On Tue, 1 Nov 2005 01:51:25 +
 Ciaran McCreesh [EMAIL PROTECTED] wrote:
 
  The attached GLEP is a draft proposal for the emerge --news thing that's
  been under discussion. There are still some TODO items. These are calls
  for people to weigh in with suggestions. Of course, suggestions on other
  items are good too...
 
 Before this, make pre-install and post-install emerge messages more usable,
 instead of having them lost among thousands of gibberish text in batch 
 emerges.
 

I always ask myself what's wrong with doing a simple if
statement before displaying infos, warnings or errors which
don't affect the current installaion.

No one complained when i started doing that ages ago in
bash-completion.

I don't mean huge and resource hungry tests. But why tell the
user that he should remove a file in /etc with einfo when it
doesn't even exist? (That's just an example)

Some ebuilds do this now, but most still broadcast (sometimes
huge) text floods.
-- 
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Chris Gianelloni
On Tue, 2005-11-01 at 12:26 +, Ciaran McCreesh wrote:
 On Tue, 01 Nov 2005 13:16:03 +0100 Thierry Carrez [EMAIL PROTECTED]
 wrote:
 | For them to know about it, they need to be warned when they do their
 | emerge -p world or emerge -a mysql that the upgrade is not as easy
 | as it seems. People using a cron job to sync are probably a
 | significant part of our user base...
 
 Have Portage give a red flashy before emerge if there're unread news
 items?

Or have it die unless they have
I_LIKE_A_BROKEN_SYSTEM_PLEASE_IGNORE_NEWS=yes in make.conf ;]

 Although, a better solution for users who cron sync would be to have
 said cron mail them all the relevant news files...

We don't have control over what they do in cron, we do have control over
portage itself.

-- 
Chris Gianelloni
Release Engineering - Strategic Lead
x86 Architecture Team
Games - Developer
Gentoo Linux


signature.asc
Description: This is a digitally signed message part


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Ciaran McCreesh
On Tue, 1 Nov 2005 17:22:29 +0100 Jan Kundrát [EMAIL PROTECTED] wrote:
| What's wrong with XML format similar to the one that is used for our
| GLSAs?

1. Portage does not handle XML. Portage will not handle XML in the
near future.

2. Many users do not have an XML parser installed.

3. The standard Unix tools cannot be used on XML files.

4. Bloat.

5. XML is merely adding another problem to the one we have already.

There is no XML in this GLEP for the same reasons that there is no
Java, CORBA, EJBs, web services, on demand computing initiatives or
invisible pink unicorns.

I have an eselect module which can read these news files. The whole
thing is about the same size as the DTD would need to be for an
XML-based solution. I have a parser written for the format in question.
The whole thing is smaller than the initialisation code for an off the
shelf XML parser.

It's not a question of what's wrong with XML?. It's a question of
what advantage would we gain by strapping a giant flapping wet kipper
to a bicycle?.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpUIAhOatTRa.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Ciaran McCreesh
On Tue, 1 Nov 2005 15:16:27 +0100 Paul de Vrieze [EMAIL PROTECTED]
wrote:
| I have one suggestion on an added header. I think that an Overrides: 
| header should be added. This is for those messages that make a
| previous message obsolete. Say for example that an upgrade guide to
| modular X was posted, but that a critical error was made in it. This
| was fixed, and to make sure that people read the new message, it is
| not a higher version.
| 
| It is however not a good idea to have people then read the old
| message when the new message is there.

Hrm. The advantage of this over simply removing the old news item is
that it'll work if the user keeps unread messages around between
multiple syncs. The disadvantage is that it makes the implementation a
bit trickier. Opinions on the tradeoff?

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail: ciaranm at gentoo.org
Web : http://dev.gentoo.org/~ciaranm



pgpnVKdFoIm7A.pgp
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Andrej Kacian
On Tue, 1 Nov 2005 18:18:55 +
Ciaran McCreesh [EMAIL PROTECTED] wrote:

 | Before this, make pre-install and post-install emerge messages more
 | usable, instead of having them lost among thousands of gibberish text
 | in batch emerges.
 
 Separate issue. That one's the whole elog thing.

Yes, it is a separate issue, but it's an issue that's been around for far too
long, and seems to be ignored, despite the apparent importance of emerge
messages for users.

-- 
Andrej Ticho Kacian ticho at gentoo dot org
Gentoo Linux Developer - net-mail, antivirus, sound, x86


signature.asc
Description: PGP signature


Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Alec Joseph Warner



Andrej Kacian wrote:

On Tue, 1 Nov 2005 18:18:55 +
Ciaran McCreesh [EMAIL PROTECTED] wrote:



| Before this, make pre-install and post-install emerge messages more
| usable, instead of having them lost among thousands of gibberish text
| in batch emerges.

Separate issue. That one's the whole elog thing.



Yes, it is a separate issue, but it's an issue that's been around for far too
long, and seems to be ignored, despite the apparent importance of emerge
messages for users.



http://search.gmane.org/search.php?group=gmane.linux.gentoo.portage.develquery=elog

The first 7 or 8 results should about cut it.  As for it taking forever, 
code doesn't write itself, and 1000's of whining users/devs don't get 
code written either.

--
gentoo-dev@gentoo.org mailing list



Re: [gentoo-dev] GLEP ??: Critical News Reporting

2005-11-01 Thread Grant Goodyear
Andrej Kacian wrote: [Tue Nov 01 2005, 01:20:54PM CST]
  Separate issue. That one's the whole elog thing.
 
 Yes, it is a separate issue, but it's an issue that's been around for far too
 long, and seems to be ignored, despite the apparent importance of emerge
 messages for users.

That seems a bit unfair to me.  There's a complete logging facility in
portage CVS for a version that's probably not going to be released, but
I believe that the logging stuff is being back-ported to the current
version of portage.  (Moreover, I would argue that this issue was never
ignored, but it often wasn't at the top of the list for what our limited
portage devs should be working on: see
http://bugs.gentoo.org/show_bug.cgi?id=11359#c83 .)

-g2boojum-
-- 
Grant Goodyear  
Gentoo Developer
[EMAIL PROTECTED]
http://www.gentoo.org/~g2boojum
GPG Fingerprint: D706 9802 1663 DEF5 81B0  9573 A6DC 7152 E0F6 5B76


pgpu0sLTvbkF5.pgp
Description: PGP signature


  1   2   >