You are viewing a plain text version of this content. The canonical link for it is here.
Posted to log4php-dev@logging.apache.org by Ivan Habunek <iv...@gmail.com> on 2011/01/08 15:50:24 UTC
New site docs
As you may have noticed, I just made a rather large commit updating the
user documentation on the site.
I started by just adding examples of XML configuration to existing docs,
but I wasn't very happy about the state of the documentation in general.
A lot of it was adapted from log4j, and log4php has moved on in
development since it was crated as a copy of log4j. So I expanded where
I could, and rewrote a fair amount of it to make it easier to understand.
It took me a couple of months since I learned details of how log4php
works along the way. The work is not done yet, some chapters still need
to be rewritten (e.g. configuration) but I feel that this makes a good
foundation for further work. I hope you what I have done.
The Doxia APT format proved to be very limiting. I especially miss code
coloring, and numbering. Is APT really our only option?
By now, I'm pretty fed up with writing documentation and hope to do some
more work on the codebase. :)
Regards,
Ivan
Re: New site docs
Posted by Ivan Habunek <iv...@gmail.com>.
On 12.1.2011. 14:20, Christian Grobmeier wrote:
> Not sure... but:
> http://incubator.apache.org/projects/log4php.html
> mentions the 2004-01-06
>
> I think we can use that date
>
Yey. We have our very own projects page. :)
http://projects.apache.org/projects/log4php.html
Regards,
Ivan
Re: New site docs
Posted by Ivan Habunek <iv...@gmail.com>.
On 26.1.2011. 3:47, Curt Arnold wrote:
> I checked the authorization file and it looks like the only PMC members had write privileges to the site directory. I modified the asf-authorization-template (r784117) so that any logging committer has write privileges to site directory since it is part of the release prep for any project.
>
> I do not know how long it will be before it is effective. I'm not sure how to push it myself, but the SVN master appears to be updated at least daily, so someone else should update the live file if it is not done automatically.
Thanks, that's great. I'll give it a whirl again later.
Ivan
Re: New site docs
Posted by Christian Grobmeier <gr...@gmail.com>.
Thanks Curt
On Wed, Jan 26, 2011 at 3:47 AM, Curt Arnold <ca...@apache.org> wrote:
> I checked the authorization file and it looks like the only PMC members had write privileges to the site directory. I modified the asf-authorization-template (r784117) so that any logging committer has write privileges to site directory since it is part of the release prep for any project.
>
> I do not know how long it will be before it is effective. I'm not sure how to push it myself, but the SVN master appears to be updated at least daily, so someone else should update the live file if it is not done automatically.
>
>
> On Jan 21, 2011, at 1:41 AM, Ivan Habunek wrote:
>
>> Well, I tried updating the site, but it seems that I don't have the permissions. I get the following message:
>> svn: Commit failed (details follow):
>> svn: access to '/repos/asf/!svn/ver/941572/logging/site/trunk/docs/log4php/apidocs/classtrees_log4php.html' forbidden
>>
>> Who is the right person to talk to about this?
>>
>> Regards,
>> Ivan
>
>
--
http://www.grobmeier.de
Re: New site docs
Posted by Curt Arnold <ca...@apache.org>.
I checked the authorization file and it looks like the only PMC members had write privileges to the site directory. I modified the asf-authorization-template (r784117) so that any logging committer has write privileges to site directory since it is part of the release prep for any project.
I do not know how long it will be before it is effective. I'm not sure how to push it myself, but the SVN master appears to be updated at least daily, so someone else should update the live file if it is not done automatically.
On Jan 21, 2011, at 1:41 AM, Ivan Habunek wrote:
> Well, I tried updating the site, but it seems that I don't have the permissions. I get the following message:
> svn: Commit failed (details follow):
> svn: access to '/repos/asf/!svn/ver/941572/logging/site/trunk/docs/log4php/apidocs/classtrees_log4php.html' forbidden
>
> Who is the right person to talk to about this?
>
> Regards,
> Ivan
Re: New site docs
Posted by Christian Grobmeier <gr...@gmail.com>.
hu, you should be able to commit to the trunk.
Are you sure you use the https:// link?
>From what I know, it should work.
if not, can you re-ask this question on general@logging group? Maybe
there is someting i dont know.
If there is not outcome, you need to ask on infra@, the can probably
help with clarifiyng
cheers + thanks for taking care, works kills me currently :-)
2011/1/21 Ivan Habunek <iv...@gmail.com>:
> Well, I tried updating the site, but it seems that I don't have the
> permissions. I get the following message:
> svn: Commit failed (details follow):
> svn: access to
> '/repos/asf/!svn/ver/941572/logging/site/trunk/docs/log4php/apidocs/classtrees_log4php.html'
> forbidden
>
> Who is the right person to talk to about this?
>
> Regards,
> Ivan
>
--
http://www.grobmeier.de
Re: New site docs
Posted by Ivan Habunek <iv...@gmail.com>.
Well, I tried updating the site, but it seems that I don't have the
permissions. I get the following message:
svn: Commit failed (details follow):
svn: access to
'/repos/asf/!svn/ver/941572/logging/site/trunk/docs/log4php/apidocs/classtrees_log4php.html'
forbidden
Who is the right person to talk to about this?
Regards,
Ivan
Re: New site docs
Posted by Christian Grobmeier <gr...@gmail.com>.
>
> Also, I noticed that log4php is not listed on apache's project listing
> (http://projects.apache.org/indexes/alpha.html). I have created a doap
> rdf file which is needed for this and I will commit it to the
> repository. However, one of the bits of info needed is project
> creation date. Now the initial import in SVN history is dated on
> 08.03.2004. but there was a migration from a csv repository around
> that time. Do you know when the project was initially created?
Not sure... but:
http://incubator.apache.org/projects/log4php.html
mentions the 2004-01-06
I think we can use that date
Cheers
>
> Regards,
> Ivan
>
--
http://www.grobmeier.de
Re: New site docs
Posted by Ivan Habunek <iv...@gmail.com>.
On 12 January 2011 12:36, Christian Grobmeier <gr...@gmail.com> wrote:
> I think: https://svn.apache.org/repos/asf/logging/log4php/site
> is outdated. I don't remember when it came in but I think it was
> already there before i picked up log4php
> Looking at the files, they seem rather old. I have no objections to
> remove this folder - it contains only old generated sources, no idea
> why we should keep them.
I have done so.
>> Also, I noticed that I used the term "ini file" instead of "properties file"
>> as is commonly known in the Java world. Maybe I should change this...
>
> Sounds good, go ahead
I'll do this as well when I get a little free time.
Also, I noticed that log4php is not listed on apache's project listing
(http://projects.apache.org/indexes/alpha.html). I have created a doap
rdf file which is needed for this and I will commit it to the
repository. However, one of the bits of info needed is project
creation date. Now the initial import in SVN history is dated on
08.03.2004. but there was a migration from a csv repository around
that time. Do you know when the project was initially created?
Regards,
Ivan
Re: New site docs
Posted by Christian Grobmeier <gr...@gmail.com>.
Hi Ivan
> As far as I figured out, I have to generate the new site, commit it to
> https://svn.apache.org/repos/asf/logging/site/trunk/docs/log4php and then
> update it from svn on people.apache.org. If so, what is the purpose of
> https://svn.apache.org/repos/asf/logging/log4php/site? Is there anything
> else that has to be done?
I think: https://svn.apache.org/repos/asf/logging/log4php/site
is outdated. I don't remember when it came in but I think it was
already there before i picked up log4php
Looking at the files, they seem rather old. I have no objections to
remove this folder - it contains only old generated sources, no idea
why we should keep them.
> Also, I noticed that I used the term "ini file" instead of "properties file"
> as is commonly known in the Java world. Maybe I should change this...
Sounds good, go ahead
Cheers,
Christian
Re: New site docs
Posted by Ivan Habunek <iv...@gmail.com>.
Christian, can you advise me about deploying the new site?
As far as I figured out, I have to generate the new site, commit it to
https://svn.apache.org/repos/asf/logging/site/trunk/docs/log4php and
then update it from svn on people.apache.org. If so, what is the purpose
of https://svn.apache.org/repos/asf/logging/log4php/site? Is there
anything else that has to be done?
Also, I noticed that I used the term "ini file" instead of "properties
file" as is commonly known in the Java world. Maybe I should change this...
Regards,
Ivan
On 8.1.2011. 15:50, Ivan Habunek wrote:
> As you may have noticed, I just made a rather large commit updating
> the user documentation on the site.
>
> I started by just adding examples of XML configuration to existing
> docs, but I wasn't very happy about the state of the documentation in
> general. A lot of it was adapted from log4j, and log4php has moved on
> in development since it was crated as a copy of log4j. So I expanded
> where I could, and rewrote a fair amount of it to make it easier to
> understand.
>
> It took me a couple of months since I learned details of how log4php
> works along the way. The work is not done yet, some chapters still
> need to be rewritten (e.g. configuration) but I feel that this makes a
> good foundation for further work. I hope you what I have done.
>
> The Doxia APT format proved to be very limiting. I especially miss
> code coloring, and numbering. Is APT really our only option?
>
> By now, I'm pretty fed up with writing documentation and hope to do
> some more work on the codebase. :)
>
> Regards,
> Ivan