cpp-netlib-devel

[cpp-netlib-devel] HTML docs on github

[Glyn M. <gly...@gm...>]

Hi Guys,


I have made some structural changes to the quickbook sources in my own fork,
and I have been able to publish the results on github:

http://glynos.github.com/cpp-netlib/

The content hasn't changed so much but if Dean and Jeroen are updating the
docs, I'd appreciate it if you'd use these changes in my fork (branch
0.5-devel).

Comments in general about the content are also welcome.

Glyn

Re: [cpp-netlib-devel] HTML docs on github

[Dean M. B. <mik...@gm...>]

Hi Glyn!

On Thu, Jan 21, 2010 at 5:07 AM, Glyn Matthews <gly...@gm...> wrote:
> Hi Guys,
>
>
> I have made some structural changes to the quickbook sources in my own fork,
> and I have been able to publish the results on github:
>
> http://glynos.github.com/cpp-netlib/
>

This is so cool! I should learn to do this one of these days. :D

> The content hasn't changed so much but if Dean and Jeroen are updating the
> docs, I'd appreciate it if you'd use these changes in my fork (branch
> 0.5-devel).
>

Definitely. Send me a pull request so I can merge your work into my
branch. I'll take on some housekeeping with the HTTP client example
changes -- we broke backward compatibility in 0.5-devel -- and general
documentation for the HTTP Server documentation.

> Comments in general about the content are also welcome.
>

There are some typographical errors that I see, I'll file issues on
your fork's tracker so that we can track those there too.

One quick thing is that the marker image doesn't show -- you may have
forgotten to put them images into the appropriate directory. ;)

Thanks again for the great effort on the documentation -- I shall
reply in kind soon enough once my consulting work winds down a little.

-- 
Dean Michael Berris
cplusplus-soup.com | twitter.com/deanberris
linkedin.com/in/mikhailberis | facebook.com/dean.berris | deanberris.com

Re: [cpp-netlib-devel] HTML docs on github

[Jeroen H. <vex...@gm...>]

Hi,

On Wed, Jan 20, 2010 at 22:07, Glyn Matthews <gly...@gm...> wrote:
> Hi Guys,
>
>
> I have made some structural changes to the quickbook sources in my own fork,
> and I have been able to publish the results on github:
>
> http://glynos.github.com/cpp-netlib/
>
> The content hasn't changed so much but if Dean and Jeroen are updating the
> docs, I'd appreciate it if you'd use these changes in my fork (branch
> 0.5-devel).
>

Gladly, though I have no idea how to pull them into my current fork.

> Comments in general about the content are also welcome.
>
> Glyn
>

Jeroen

Re: [cpp-netlib-devel] HTML docs on github

[Glyn M. <gly...@gm...>]

Hi Dean,

2010/1/20 Dean Michael Berris <mik...@gm...>

> Hi Glyn!
>
> On Thu, Jan 21, 2010 at 5:07 AM, Glyn Matthews <gly...@gm...>
> wrote:
> > Hi Guys,
> >
> >
> > I have made some structural changes to the quickbook sources in my own
> fork,
> > and I have been able to publish the results on github:
> >
> > http://glynos.github.com/cpp-netlib/
> >
>
> This is so cool! I should learn to do this one of these days. :D
>

Very easy to do, the instructions can be found if you go to a page that
doesn't exist, like:

http://cpp-netlib.github.com/


>
> > The content hasn't changed so much but if Dean and Jeroen are updating
> the
> > docs, I'd appreciate it if you'd use these changes in my fork (branch
> > 0.5-devel).
> >
>
> Definitely. Send me a pull request so I can merge your work into my
> branch. I'll take on some housekeeping with the HTTP client example
> changes -- we broke backward compatibility in 0.5-devel -- and general
> documentation for the HTTP Server documentation.
>
> > Comments in general about the content are also welcome.
> >
>
> There are some typographical errors that I see, I'll file issues on
> your fork's tracker so that we can track those there too.
>

Yeah, i'm sure there are loads it's always easy to miss them.


>
> One quick thing is that the marker image doesn't show -- you may have
> forgotten to put them images into the appropriate directory. ;)
>
>
The links to the marker images are on boost.org, which don't seem to exist.
I don't know how to fix this.


> Thanks again for the great effort on the documentation -- I shall
> reply in kind soon enough once my consulting work winds down a little.
>
> OK, thanks.
G

Re: [cpp-netlib-devel] HTML docs on github

[Dean M. B. <mik...@gm...>]

On Thu, Jan 21, 2010 at 5:46 AM, Glyn Matthews <gly...@gm...> wrote:
>
> 2010/1/20 Dean Michael Berris <mik...@gm...>
>>
>>
>> This is so cool! I should learn to do this one of these days. :D
>
> Very easy to do, the instructions can be found if you go to a page that
> doesn't exist, like:
>
> http://cpp-netlib.github.com/
>

Nice! Thanks I'll look into doing that one of these days. Sure beats
having to do it via SSH on sourceforge IMO. ;)

>>
>> One quick thing is that the marker image doesn't show -- you may have
>> forgotten to put them images into the appropriate directory. ;)
>>
>
> The links to the marker images are on boost.org, which don't seem to exist.
> I don't know how to fix this.
>

Oh, okay. I remember those being part of the quickbook images when you
build the documentation that came with the example. We can host those
images ourselves too.

>>
>> Thanks again for the great effort on the documentation -- I shall
>> reply in kind soon enough once my consulting work winds down a little.
>>
> OK, thanks.

BTW, I saw that you sent a pull request already, but it seems you
haven't pulled the latest changes I've made in 0.5-devel into your
fork's 0.5-devel branch. I think there's documentation on how to do
that already available here: http://help.github.com/forking/ -- once
you reconcile the conflicts (if there are any, and it looks like there
will be some because there's quite a number of them commits you have
that failed to apply cleanly) and push back to your fork, I should be
able to pull them cleanly from Github.

Thanks again and I hope this helps!

-- 
Dean Michael Berris
cplusplus-soup.com | twitter.com/deanberris
linkedin.com/in/mikhailberis | facebook.com/dean.berris | deanberris.com

Re: [cpp-netlib-devel] HTML docs on github

[Glyn M. <gly...@gm...>]

2010/1/20 Dean Michael Berris <mik...@gm...>

> On Thu, Jan 21, 2010 at 5:46 AM, Glyn Matthews <gly...@gm...>
> wrote:
> >
> > 2010/1/20 Dean Michael Berris <mik...@gm...>
> >>
> >>
> >> This is so cool! I should learn to do this one of these days. :D
> >
> > Very easy to do, the instructions can be found if you go to a page that
> > doesn't exist, like:
> >
> > http://cpp-netlib.github.com/
> >
>
> Nice! Thanks I'll look into doing that one of these days. Sure beats
> having to do it via SSH on sourceforge IMO. ;)
>
> >>
> >> One quick thing is that the marker image doesn't show -- you may have
> >> forgotten to put them images into the appropriate directory. ;)
> >>
> >
> > The links to the marker images are on boost.org, which don't seem to
> exist.
> > I don't know how to fix this.
> >
>
> Oh, okay. I remember those being part of the quickbook images when you
> build the documentation that came with the example. We can host those
> images ourselves too.
>
> >>
> >> Thanks again for the great effort on the documentation -- I shall
> >> reply in kind soon enough once my consulting work winds down a little.
> >>
> > OK, thanks.
>
> BTW, I saw that you sent a pull request already, but it seems you
> haven't pulled the latest changes I've made in 0.5-devel into your
> fork's 0.5-devel branch. I think there's documentation on how to do
> that already available here: http://help.github.com/forking/ -- once
> you reconcile the conflicts (if there are any, and it looks like there
> will be some because there's quite a number of them commits you have
> that failed to apply cleanly) and push back to your fork, I should be
> able to pull them cleanly from Github.
>
>
OK, that will have to wait because I can't access Github from work.
G