[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#771825: release-notes: Update information on non-systemd Jessie upgrades and installations



On Tue, 2014-12-02 at 22:16 +0100, Niels Thykier wrote:
> On 2014-12-02 18:17, Svante Signell wrote:
> > Package: release-notes
> > Severity: Important
> > 
> > Hello,
> > 
> > As promised on debian-devel attached is a first proposal for an update
> > of the release notes. There are two small issues with the patch:
> > - The text is edited without seeing the markup result. How to do that?
> > - The second part about preseeding will be tested tonight, and an
> > updated patch will be submitted if any changes are needed.
> > 
> > Thanks!
> > 
> 
> Hi,
> 
> Thanks for taking the time to write a patch for the release notes.
> 
> I have two remarks:
> 
>  * It is not clear to me that this is a valid patch against the original
>    source of the release notes (SVN)[1].  I can certainly extract the
>    relevant parts and apply it manually, but this is inefficient use of
>    our time (yours and mine) in the long run.

See below.

>  * The second "hunk" of the patch seems better suited for the
>    installation-guide.  The release notes concerns itself with upgrades
>    and does not cover the debian-installer.

Somebody was complaining that changing the installation-guide was a lot
of work, e.g. translations work, and did not want the changes to be made
there https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=765803#40
I don't mind getting the second part included there instead.

> The original source of the release notes is at [2].  There is a git
> clone maintained by Julien at [3] if you prefer git over SVN.
> 
> To build the release notes (for a single language and architecture), you
> run:
> 
>   make html LINGUA="en" architecture=amd64
> 
> Which would build the English HTML version for amd64.  The generated
> output will be in en/release-notes.amd64.html/index.en.html.
>   NB:  Some parts of the build system assumes you have a subversion
> checkout.  The above command does not, but if you simply run "make"
> without any arguments you will trigger some of them.

I will fix that tomorrow, thanks!

> ~Niels
> 
> [1] I would be expecting you to modify a file called "en/issues.dbk"...
> and I am not sure what the "numbers" at the beginning of each line is
> doing in an XML document, but...

I did cut and paste from the web page in iceweasel:

https://anonscm.debian.org/viewvc/ddp/manuals/trunk/release-notes/en/issues.dbk?view=markup&pathrev=10511

That's where the line numbers came from. I should have downloaded the
page and edited that one instead.

> [2] https://anonscm.debian.org/viewvc/ddp/manuals/trunk/release-notes/
> 
> [3] https://anonscm.debian.org/cgit/users/jcristau/release-notes.git/
> 
> 


Reply to: