Re: [PHP-DOC] Re: Getting more people involved.. bye bye Docbook

[pedram salehpoor]

I was unable to find any decent rtl extension for Markdown except some
javascript stuff
but Docutils uses Python code and CSS to give bidirectional support to rst.

It seems no rtl language has ever given any thought to use these in large
scale or maybe I was unable to find them.


On Tue, Aug 13, 2013 at 11:53 AM, Hannes Magnusson <
hannes.magnus...@gmail.com> wrote:

> Excellent question.
>
> Do you know of any rtl examples using formats like markdown or rst?
>
> I've never really given it any thought.
>
> -Hannes
>
>
> On Tue, Aug 13, 2013 at 12:18 AM, pedram salehpoor
>  wrote:
> >  Markdown or anything easier than Docbook seems brilliant but What will
> > happen to right to left languages?
> >
> >  We couldn't solve the rtl problem in Docbook. Will the problem persist
> in
> > the new format?
> >
> >
> >
> > On Tue, Aug 13, 2013 at 9:17 AM, Hannes Magnusson
> >  wrote:
> >>
> >> As an update.. Here is an actually generated page[1] into this new
> >> markdown/rST style format, and its html rendering[2] using the new
> >> tool, wtfm[3].
> >>
> >> I still haven't received any suggested pure rST versions so will be
> >> continuing using this format for the time being atleast.
> >>
> >> -Hannes
> >>
> >> [1]
> >> https://raw.github.com/bjori/bjori.github.com/master/function.strpos.md
> >> [2] http://bjori.github.io/strpos.html
> >> [3] Write The F* Manual
> >>
> >>
> >
>

Re: [PHP-DOC] Re: Getting more people involved.. bye bye Docbook

[pedram salehpoor]

 Markdown or anything easier than Docbook seems brilliant but What will
happen to right to left languages?

 We couldn't solve the rtl problem in Docbook. Will the problem persist in
the new format?


On Tue, Aug 13, 2013 at 9:17 AM, Hannes Magnusson <
hannes.magnus...@gmail.com> wrote:

> As an update.. Here is an actually generated page[1] into this new
> markdown/rST style format, and its html rendering[2] using the new
> tool, wtfm[3].
>
> I still haven't received any suggested pure rST versions so will be
> continuing using this format for the time being atleast.
>
> -Hannes
>
> [1]
> https://raw.github.com/bjori/bjori.github.com/master/function.strpos.md
> [2] http://bjori.github.io/strpos.html
> [3] Write The F* Manual
>
>
>

Re: [PHP-DOC] User notes

[pedram salehpoor]

>
> As a normal user who copy pastes from the comments
> keep
>
> Just because the supply of good v bad is a low percentage
> does not mean the system is bad
>
> I agree. User notes have saved me lots of times when it seemed everything
is impossible.

I remember that I proposed to change the system myself but as I proceeded I
realized nothing really can overcome the problems better than this.

I don't like outsourcing Idea. The best possible solution is to merge them
in documentation.

The main problem is that each of us has his own area of interest and can
merge them best. As Hannes said better to encourage develepers.

And hey long time no see.

Best,
Pedram

Re: [PHP-DOC] Translating PHP documents to Persian

[pedram salehpoor]

Please take a look at

edit.php.net This is an online editor for documentation.
http://doc.php.net/php/dochowto/ This is the how to page.
doc...@lists.php.net  This is persian translation mailing list.



On Thu, Feb 3, 2011 at 6:16 PM, afshin@gmail.com
wrote:

> Hi dear Pedram,
>
> Currently i work in Tadbir Pardaz Co. as a C# developer and we work with
> Microsoft SourceSafe so i don't familiar with SVN or Docbook but i already
> work with XML.
>
> Regards,
> Afshin
>
>
>
> On Thu, Feb 3, 2011 at 3:58 PM, pedram salehpoor <
> pedram.salehp...@gmail.com> wrote:
>
>> Hi Afshin
>> I maintain persian translation.
>> Are you familiar with SVN and Docbook and xml?
>> Can I see some of your work?
>>
>> Regards,
>> Pedram
>>
>>
>> On 2/3/11, afshin@gmail.com  wrote:
>> > Hello my friend,
>> >
>> > I'm Afshin Mehrabani, a web developer and designer in Iran and i won
>> first
>> > place programming (HTML, PHP, JavaScript, Css and MySQL) competition in
>> > Iran.
>> > Now, i work in Tadbir Pardaz Co. as a web developer to developing
>> financial
>> > automations.
>> >
>> > I already translated some documentation and manuals from php.net(English)
>> > to Persian, but now i want to start and do this work again.
>> >
>> > How can I do that?
>> > Please help me.
>> >
>> > Thanks,
>> > Afshin
>> >
>>
>
>

Re: [PHP-DOC] Translating PHP documents to Persian

[pedram salehpoor]

Hi Afshin
I maintain persian translation.
Are you familiar with SVN and Docbook and xml?
Can I see some of your work?

Regards,
Pedram


On 2/3/11, afshin@gmail.com  wrote:
> Hello my friend,
>
> I'm Afshin Mehrabani, a web developer and designer in Iran and i won first
> place programming (HTML, PHP, JavaScript, Css and MySQL) competition in
> Iran.
> Now, i work in Tadbir Pardaz Co. as a web developer to developing financial
> automations.
>
> I already translated some documentation and manuals from php.net (English)
> to Persian, but now i want to start and do this work again.
>
> How can I do that?
> Please help me.
>
> Thanks,
> Afshin
>

Re: [PHP-DOC] Official movement to clean old PHP versions from the documentation

[pedram salehpoor]

I think we should only get rid of << php 5.0.

If it is possible a sample old and new page should be created that
shows how the normal process of changes should follow in the
documentation.

Regards,
Pedram

On 1/16/11, Alexey Shein  wrote:
> 2011/1/15 Daniel Brown :
>> On Sat, Jan 15, 2011 at 05:52, Julien Pauli  wrote:
>>>
>>> Last time (http://marc.info/?l=phpdoc&m=128686832705180&w=2) , we
>>> suggested that [old-and-not-supported-versions] = PHP4 + PHP5.0 +
>>> PHP5.1 ; and [up-to-date-versions] = PHP5.2 + PHP5.3
>>
>>-1
>>
>>Getting rid of PHP4, sure, but I think it's a horrible idea to get
>> rid of all PHP < 5.2 references.
>>
>
> Agreed with Daniel, I think that it's too early to throw out 5.0 and
> 5.1 docs. I quite often see servers with PHP 5.1 installed, so it will
> be valuable to have such information in the docs.
> Interesting info was gathered by Ilia Alshanetsky here:
> http://phpadvent.org/2010/usage-statistics-by-ilia-alshanetsky (PHP4
> is still used on more than 20% domains in the world, and PHP 5.1 is
> just 8%).

Re: [PHP-DOC] This PHP Manual build is broken

[pedram salehpoor]

Hi,

Thanks for your help.

Pedram

On Thu, Jan 6, 2011 at 11:07 AM, Adam Harvey  wrote:
>
> On 6 January 2011 14:15, Apache  wrote:
> > The  build of the PHP Manual is broken, so it does not validate or build. 
> > Please fix it! ;)
>
> Fixed in r307153.
>
> > Love,
> >        The docs.php.net server
>
> Hugs and kisses,
>         Adam

Re: [PHP-DOC] Fwd: Farewell CHM, hello EPUB!

[pedram salehpoor]

I hope it will not have problems about right to left languages.

Regards,
Pedram
>
> We may as well do this too.
>
> I immediately downloaded the EPUB version from mysql.com and spent 5 minutes
> trying to open it on my Mac, and failed. Sure this can be overcome with
> education but it's worth noting that it's not easy, yet, and feels geared
> towards mobile devices so far. I didn't try the Firefox plugin. Although,
> the MySQL epub download appears to be missing an .epub file but I don't know
> the topic.
>
> Regardless of my epub ignorance, I think it's a good idea to offer this
> alternative via PhD. I vaguely remember it coming up before, but now forget.
>
> Regards,
> Philip
>
> Begin forwarded message:
>
>> From: Brett Bieber 
>> Date: September 6, 2010 6:10:38 AM PDT
>> To: PEAR Doc List 
>> Subject: [PEAR-DOC] Fwd: Farewell CHM, hello EPUB!
>>
>> An interesting announcement here — I know we've had plenty of issues
>> with our CHM manuals, and maybe this is something we should consider.
>> I would be in favor of an epub format for our manual.
>>
>>
>> -- Forwarded message --
>> From: Stefan Hinz 
>> Date: Mon, Sep 6, 2010 at 4:31 AM
>> Subject: Farewell CHM, hello EPUB!
>> To: annou...@lists.mysql.com
>>
>>
>> For a long time, the MySQL Documentation Team has been providing CHM
>> files for most MySQL documentation we publish. Like many other formats,
>> CHM-format docs can be downloaded from http://dev.mysql.com/doc. CHM
>> (Compiled HTML Help) has been the de facto standard help file format on
>> Windows since 1997, but the technology behind it is outdated and has all
>> kinds of quirks. The successor format introduced with Windows Vista is
>> AP Help, but it hasn't taken off in practice so far. So, with CHM being
>> outdated and AP Help spread anything but widely, lots of vendors have
>> started providing documentation on Windows in PDF or HTML format.
>>
>> Building CHM-format documentation is a challenge of its own. I'll not go
>> into details here, so let me just state that it requires a dedicated
>> Windows box (or VM), and while it can be automated using Power Shell
>> commands, there's no way to find out whether or not a CHM file was built
>> correctly, except by manual inspection. This makes it different from all
>> other documentation formats where technical QA is done (successfully) in
>> an automated fashion.
>>
>> With the increasing complexity and size of our documentation (the MySQL
>> 5.1 Manual contains more than 1.6 million words now!), providing CHM has
>> become more and more of a pain, because builds tend to break more often.
>> We've stopped shipping CHM with the MySQL Server on Windows months ago
>> because we simply couldn't guarantee that the help file shipped with the
>> software would work. Also, we're running short on hardware resources, so
>> we'd rather stop wasting the resources we have on building a format
>> that's of limited use, anyway.
>>
>> This is why we'll stop providing CHM for any of the documentation we
>> publish.
>>
>> To alleviate potential pains anyone might have with this decision, let
>> me tell you that we've started providing EPUB-format docs. EPUB (see
>> http://en.wikipedia.org/wiki/EPUB) is an open standard format for screen
>> readers, mobile or not, and is fairly easy (and not resource-intensive!)
>> to compile. Thanks to Lenz for suggesting to build EPUB!
>>
>> Go to http://dev.mysql.com/doc to grab MySQL documentation in EPUB
>> format. To read EPUB on desktop machines, I use a Firefox add-on,
>> unsurprisingly called epubreader, which loads EPUB documents fast and
>> renders them nicely. That said, please be aware that EPUB can't do
>> anything about the fact that the MySQL Reference Manual is huge, so
>> downloading it to a mobile device can take a while. The MySQL 5.1 Manual
>> is currently a whopping 15 MB!
>>
>> See also: http://blogs.sun.com/mysqlf/entry/farewell_chm_hello_epub
>>
>> --
>> Cheers,
>>
>> Stefan Hinz , MySQL Documentation Manager
>>
>> Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc
>>
>> ORACLE Deutschland B.V.&  Co. KG
>> Registered Office: Riesstr. 25, 80992 Muenchen, Germany
>> Commercial Register: Local Court Of Munich, HRA 95603
>>
>> General Partner: ORACLE Deutschland Verwaltung B.V.
>> Rijnzathe 6, 3454PV De Meern, Niederlande
>> Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
>> Managing Directors: Juergen Kunz, Marcel van de Molen,
>> Alexander van der Ven
>>
>> --
>> MySQL Announce Mailing List
>> For list archives: http://lists.mysql.com/announce
>> To unsubscribe:
>> http://lists.mysql.com/announce?unsub=brett.bie...@gmail.com
>>
>>
>>
>>
>> --
>> Brett Bieber
>>
>> --
>> PEAR Documentation List Mailing List (http://pear.php.net/)
>> To unsubscribe, visit: http://www.php.net/unsub.php
>>
>
>

Re: [PHP-DOC] Re: Error when compiling PHP manual.

[pedram salehpoor]

On Fri, May 21, 2010 at 1:20 PM, Richard Quadling
 wrote:
>
> On 21 May 2010 05:01, Philip Olson  wrote:
> >
> > On May 20, 2010, at 8:52 PM, Yago Ferrer wrote:
> >
> >> Hi Philip!
> >>
> >> When I´m trying to compile the Spanish PHP manual I´m getting these 
> >> errors, do you know what is it?
> >>
> >> Warning: DOMDocument::xinclude(): XPointer evaluation failed: 
> >> #xmlns(db=http://docbook.org/ns/docbook) 
> >> xpointer(id('class.datetime')/db:refentry/db:refsec...@role='description']/descendant::db:destructorsynopsis[not(@role='procedural')])
> >>  in /local/web/sites/edit.php.net/data/phpdoc-all/doc-base/configure.phpon 
> >> line 613
> >>
> >> Warning: DOMDocument::xinclude(): XPointer evaluation failed: 
> >> #xmlns(db=http://docbook.org/ns/docbook) 
> >> xpointer(id('class.datetimezone')/db:refentry/db:refsec...@role='description']/descendant::db:destructorsynopsis[not(@role='procedural')])
> >>  in /local/web/sites/edit.php.net/data/phpdoc-all/doc-base/configure.php 
> >> on line 613
> >>
> >> Warning: DOMDocument::xinclude(): XPointer evaluation failed: 
> >> #xmlns(db=http://docbook.org/ns/docbook) 
> >> xpointer(id('class.dateinterval')/db:refentry/db:refsec...@role='description']/descendant::db:destructorsynopsis[not(@role='procedural')])
> >>  in /local/web/sites/edit.php.net/data/phpdoc-all/doc-base/configure.phpon 
> >> line 613
> >>
> >> Warning: DOMDocument::xinclude(): XPointer evaluation failed: 
> >> #xmlns(db=http://docbook.org/ns/docbook) 
> >> xpointer(id('class.dateperiod')/db:refentry/db:refsec...@role='description']/descendant::db:destructorsynopsis[not(@role='procedural')])
> >>  in /local/web/sites/edit.php.net/data/phpdoc-all/doc-base/configure.phpon 
> >> line 613
> >>
> >> Warning: DOMDocument::xinclude(): XPointer evaluation failed: 
> >> #xmlns(db=http://docbook.org/ns/docbook) 
> >> xpointer(id('class.dateperiod')/db:refentry/db:refsec...@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])
> >>  in /local/web/sites/edit.php.net/data/phpdoc-all/doc-base/configure.php 
> >> on line 613
> >
> > Nope, and I can't reproduce (even after trying a fresh doc-es checkout).
> >
> > However, yesterday people saw these errors when unrelated errors occurred 
> > in the manual. The mongo docs briefly had a  in the wrong place, yet 
> > these nasty looking datetime errors showed up (along with the correct mongo 
> > errors too). Therefore I wonder, whenever we have a problem we might see 
> > these too which is very confusing. Anyone have an idea regarding how to fix 
> > that?
> >
> > Regards,
> > Philip
>
> Can you check the version of libxml that is being used by the online
> editor please?
>
> I recently added the new xinclude/xpointer/xfallback to the datetime
> (in all the translations).
>
> I did do a thorough test locally.
>
> I'm using Windows and have to use the --disable-libxml-check as the
> last official win32 version of PHP is using ...
>
> Constant [ integer LIBXML_VERSION ] { 20703 }
> Constant [ string LIBXML_DOTTED_VERSION ] { 2.7.3 }
> Constant [ string LIBXML_LOADED_VERSION ] { 20703 }
>
> and 2.7.4+ is required or use the --disable-libxml-check to skip the
> version check.
>

The problem comes from some xinclude tags added recently which I can't
trace them.

Regards,
Pedram

Re: [PHP-DOC] PhDOE : Online editor - I need your opinion (and your help) !

[pedram salehpoor]

It seems great Yannick.

Best,
Pedram

On Fri, Apr 23, 2010 at 8:11 PM, Yannick Torrès
 wrote:
> Hi all,
> 2010/4/14 pedram salehpoor 
>>>
>> adding a new tab to tools panel seems to serve the purpose. If we could
>> add the notes to folders and files like "I will translated this folder" or
>> something like that. If in main page the newer notes are displayed that will
>> help a lot
>> but don't we have a lot of information boxes in main page already?
>>
>> If we can have notes for untranslated files (not committed in a language)
>> that would help too.
>>
>>  I was thinking that having a note page for every files is enough and thus
>> force the users to change the notes of other users or delete the older ones.
>
> I just commit a first version of user's notes ( https://edit.php.net is up
> to date too ).
> Actually, this is what I have done :
> * Notes are related to a file. There are accessible via the file panel (in
> toolbar like "save", "undo", etc.. actions).
> * We can add unlimited notes per files
> * Anonymous user can't delete / add a note
> * User can only delete his notes
> * Notes can be in HTML format
> When you are in the note's component, add/delete a note is accessible via
> the context menu (right click).
> Please, tell me what you think about this implementation.
> Now, I will see how we can extend this new component to add some notes for a
> full folder.
> Best,
> Yannick
>
>
>
>>
>> ** another idea: a big problem always bugging us translators is having
>> different translation for a word and thus having a difficult time to
>> coordinate. If we had dictionary like tool to add these words and their
>> translation it will higher the quality of translation (If it was possible to
>> change documents by changing the translated definition that would be great
>> too).
>>
>> Pedram
>
>

[PHP-DOC] Re: online documentation little bug

[pedram salehpoor]

sorry Yannick,
I was unable to find a file with that characteristics to reproduce it.
It only occurred on two files and for the first time it was added:

spl/splfileobject/fgetcsv.xml

and

spl/splfileobject/setcsvcontrol.xml

Best,
Pedram

On Fri, Apr 23, 2010 at 8:29 PM, Yannick Torrès
 wrote:
> Hi Pedram,
> Sorry for my late answer.
> Could you give me an example of file who this error occurs ?
> Best,
> Yannick
>
> 2010/4/10 pedram salehpoor 
>>
>> Hi,
>> Seems online editor error recognizer has problems regarding initializer
>> tags containing "\". It somehow always takes error about it.
>>
>> Best,
>> Pedram
>
>

Re: [PHP-DOC] problem

[pedram salehpoor]

Yeah something is wrong. the pages can't be opened.

Best,
Pedram

On Fri, Apr 23, 2010 at 8:22 PM, Jesús Cova
 wrote:
> Good morning, i'm triying to edit a document by php edit online and i can
> not open the document i push twice click and it does not open.. what could
> be happenig?
>
> --
> Regards
>
> Jesús Rafael Cova Huerta
>

Re: [PHP-DOC] PhDOE : Online editor - I need your opinion (and your help) !

[pedram salehpoor]

On Sat, Apr 17, 2010 at 1:37 AM, yannick  wrote:

> Le mercredi 14 avril 2010 19:41:21, pedram salehpoor a écrit :
> > On Wed, Apr 14, 2010 at 7:11 PM, Yannick Torrès
> wrote:
> >
> > the notes to folders and files like "I will translated this folder" or
> > something like that. If in main page the newer notes are displayed that
> > will help a lot
> > but don't we have a lot of information boxes in main page already?
> >
> > If we can have notes for untranslated files (not committed in a language)
> > that would help too.
> >
> >  I was thinking that having a note page for every files is enough and
> thus
> > force the users to change the notes of other users or delete the older
> > ones.
> >
> > ** another idea: a big problem always bugging us translators is having
> > different translation for a word and thus having a difficult time to
> > coordinate. If we had dictionary like tool to add these words and their
> > translation it will higher the quality of translation (If it was possible
> > to change documents by changing the translated definition that would be
> > great too).
>
> I just add a first attempt to add a dictionary.
> I have updated edit.php.net according to this change.
>
> Please, tell me what you think about it.
>
> Yannick, I was unable to find it. where have you added it?

Best,
Pedram

Re: [PHP-DOC] PhDOE : Online editor - I need your opinion (and your help) !

[pedram salehpoor]

On Wed, Apr 14, 2010 at 7:11 PM, Yannick Torrès wrote:

>
>>> Seems great too. i need to think more about this new idea before having a
>> more global view on it.
>> If you have already some idea on how we can add it into the UI, and how we
>> can manage this note, please, tell me.
>> Perhaps we can simply add a tab into the "tools" panel witch contains
>> already VCS history. Maybe.
>>
>
> I have start thinking per file. But if we thinks per group of files, we can
> imagine a new portlet, into the main page, witch display information posted
> by users (messages specifics per lang), somethings like one thread of a
> forum.
>
> adding a new tab to tools panel seems to serve the purpose. If we could add
the notes to folders and files like "I will translated this folder" or
something like that. If in main page the newer notes are displayed that will
help a lot
but don't we have a lot of information boxes in main page already?

If we can have notes for untranslated files (not committed in a language)
that would help too.

 I was thinking that having a note page for every files is enough and thus
force the users to change the notes of other users or delete the older ones.

** another idea: a big problem always bugging us translators is having
different translation for a word and thus having a difficult time to
coordinate. If we had dictionary like tool to add these words and their
translation it will higher the quality of translation (If it was possible to
change documents by changing the translated definition that would be great
too).

Pedram

Re: [PHP-DOC] PhDOE : Online editor - I need your opinion (and your help) !

[pedram salehpoor]

Hi, Yannick

*Using the status option in Rev tag*
>
>
> I'd like your first option more!

>
> *Introduce a new check for errors : check example syntax*
>
> that seems nice idea. As always I like to have the most information about
the status of the documentation as possible. But if it is possible to have
multiple categories for errors like severe or normal or is better or
anything like that. Currently when I see an error in my documentation, I
can't be sure If it is an urgently needing consideration or I can put to
check it some other time. If we have something like that. It will help;

>
> *Completely useless, therefore, essential ! Include a chat into the editor*
>
> I really don't like the idea of having chat in online editor. But there is
another feature that I think is
useful. I'd like to be able to put notes on files for others to see and tell
them special information about the status of the file or to
be able to organize several translator without using chat or anything else.


Best,
Pedram

[PHP-DOC] online documentation little bug

[pedram salehpoor]

Hi,
Seems online editor error recognizer has problems regarding initializer tags
containing "\". It somehow always takes error about it.

Best,
Pedram

Re: [PHP-DOC] user notes proposal

[pedram salehpoor]

I think the changes I made to these files is enough for adding basic tagging
capability.

Can someone check them and see they don't have problems? Should anything
else be changed?

TIA

Best,
Pedram
<>
<>
<>
<>

Re: [PHP-DOC] user notes proposal

[pedram salehpoor]

On Thu, Apr 8, 2010 at 10:03 PM, yannick  wrote:

> Le Jeudi 8 Avril 2010 16:45:45, Daniel Convissor a écrit :
> > Hi Pedram:
> >
> > On Thu, Apr 08, 2010 at 03:23:50PM +0430, pedram salehpoor wrote:
> > > Regarding using tags, I'd like the way books put some special notes on
> > > the
> >
> > > side of page. So I think if we use following tags it would be good:
> > Interesting.  But what do we do with the 23,377 existing notes?
> >
> > > Regarding Voting we can add forms to each not with five values:
> > Go for it.
>
> Some stars / Ajax could be great
>
>
I think we can add it after creating infrastructure needed for changes.

Best,
Pedram

Re: [PHP-DOC] user notes proposal

[pedram salehpoor]

The task would be adding type fields and reply to textbox to

http://svn.php.net/viewvc/web/php/trunk/manual/add-note.php?view=markup

modifiying the below script to accept the added fields,

http://svn.php.net/viewvc/web/php-master/trunk/entry/user-note.php?view=markup

adding fields definition to database:

http://svn.php.net/viewvc/web/php-master/trunk/note.sql?view=markup

I'm not completely sure how the mirror sites operate so someone should get
them running.

voting form and showing the point for the note from database should be added
to

http://svn.php.net/viewvc/web/php/trunk/include/shared-manual.inc?view=markup

which should have a receiving script that should be written.

I think these are the list of changes should be made. If I missed something
please notify it.

Best,
Pedram

Re: [PHP-DOC] user notes proposal

[pedram salehpoor]

On Thu, Apr 8, 2010 at 7:15 PM, Daniel Convissor <
dani...@analysisandsolutions.com> wrote:

> Hi Pedram:
>
> On Thu, Apr 08, 2010 at 03:23:50PM +0430, pedram salehpoor wrote:
> >
> > Regarding using tags, I'd like the way books put some special notes on
> the
> > side of page. So I think if we use following tags it would be good:
>
> Interesting.  But what do we do with the 23,377 existing notes?
>

That can be handled by me with a little help.

Best,
Pedram

[PHP-DOC] user notes proposal

[pedram salehpoor]

Hi everyone,
After reading old discussions and discussing ideas with philip. I'd like to
propose a way to deal with user notes. (Please smash it and get it to the
form suitable for documents)

Regarding using tags, I'd like the way books put some special notes on the
side of page. So I think if we use following tags it would be good:







for better use of these tags we can add option to select the type of note
from the user. In the page of documentation notes will be grouped regarding
their tags and will be shown and one can choose to show or not show them.

Special tags for version usually won't work because of usually ambiguous
notes.

Regarding Voting we can add forms to each not with five values:

very weak, weak, good, very good, excellent

and give them values from 1 to 5 and get average of these points for grading
notes.

Then define a threshold and if a note for some period (to be defined) of
time fell below it, it would get pruned automatically.

we can sort notes in groups defined by tags by the point given by voting
(higher notes on top).

I think this will be a good documentation user notes and easy to implement.

Best,
Pedram

Re: [PHP-DOC] Fwd: Helping with docs translations

[pedram salehpoor]

Hi, Olli

Take a look at

http://doc.php.net/php/dochowto/

for more information.

Best,
Pedram

On Thu, Apr 1, 2010 at 5:59 PM, Olli  wrote:

>
>
> -- Forwarded message --
> From: Olli 
> Date: 2010/4/1
> Subject: Fwd: Helping with docs translations
> To: phpdoc-h...@lists.php.net
>
>
> Anybody is not answered to this , can you please answr
>
>
> -- Forwarded message --
> From: Olli 
> Date: 2010/3/20
> Subject: Helping with docs translations
> To: phpdoc-h...@lists.php.net
>
>
> Hi,
>
> is it possible to help translate PHP.net Docs? Am I needed translate ALL
> functions or is it okay if I translate only one or few, so  i can see what
> it seems.
>
> i am interested Finnish
>
> Olli
>
>
>

[PHP-DOC] getting persian translation online

[pedram salehpoor]

Hi,
I think it's time to get persian translation online.

What's the process to get it online?

Best,
Pedram

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

sorry I was unable to reproduce it how hard I tried I don't why it
disappeared!

Even I solved all the errors in the persian translation but it did not pop
again but I got another problem that raises occasionally:

Sometimes there is no file in my files needed translation and after some
time the page reloads automatically like there is a loop until I sign out
and reenter to my account but I can't find any reason for it. Could it be a
problem with my internet connection or there is other problems on my side?

Best
Pedram

On Fri, Mar 19, 2010 at 1:35 AM, yannick  wrote:

> Hi Pedram,
>
> I can't reproduice this.
>
> Here is my test case, please correct me if I'm wrong.
>
> * Open a file in "error in current translation"
> * Modify the file but don't correct all error
> * Save the document (a new tab is open with all error witch haven't been
> corrected
> * Switch to the file tab without close the error tab
> * Modify it without correct all error
> * save the document
> => The error tab is focus with the new list of error
>
> No error here for me.
>
> Do you confirm ?
>
> Best,
> Yannick
>
>
> Le Jeudi 18 Mars 2010 16:34:38, pedram salehpoor a écrit :
> > Hi again,
> > There seems to be a problem with the way online editor handles error
> pages.
> >
> > Whenever I try to save a document with error, an error page is opened and
> > then if you solve some errors but not all of them and try to save it
> again
> > and the error page is open the saving fails but if you first close the
> > error page and then save it everything is okay.
> >
> > Best,
> > Pedram
> >
> > On Wed, Mar 17, 2010 at 2:06 AM, yannick 
> wrote:
> > > Le Mardi 16 Mars 2010 21:49:19, pedram salehpoor a écrit :
> > > > At last I found the source of problem!
> > > >
> > > > When the encoding of the original english file is iso-8859-1 and I
> use
> > > > Utf-8 in my documents without changing the encoding the problem
> arises
> > > > when I try saving the files
> > >
> > > I just reproduice it. We see the error output if you use tools like
> > > Firebug with Firefox.
> > >
> > > Anyway, I will send a "valid" error in this case.
> > > Fix will comming soon ;)
> > >
> > > > Pedram.
> > > >
> > > >
> > > > On Tue, Mar 16, 2010 at 4:43 PM, pedram salehpoor <
> > > >
> > > > pedram.salehp...@gmail.com> wrote:
> > > > > On Tue, Mar 16, 2010 at 4:31 PM, TORRES yannick
> > >
> > > wrote:
> > > > >> Hi Pedram,
> > > > >>
> > > > >> 2010/3/16 pedram salehpoor 
> > > > >>
> > > > >> Hi, I'm encountering some problems in the editor.
> > > > >>
> > > > >>> The editor begins two reload itself without letting me to save
> > >
> > > anything
> > >
> > > > >>> and the data is lost.
> > > > >>>
> > > > >>> When the editor tries to save new files in the directories that
> > > > >>> does not exist previously it enters a loop and never ends its
> work
> > > > >>> and after reloading the page there is a commit pending and the
> > > > >>> contents are lost and it will not show the content that has been
> > > > >>> saved and if you cancel the change again the english content
> can't
> > > > >>> be viewed until you completely reload the page.
> > > > >>>
> > > > >>> Am I doing anything wrong or what should I do?
> > > > >>
> > > > >> I'm going to try to reproduice it tonight and tell you more once
> > > > >> it's done.
> > > > >> Just one question : you try to "save" the file or "save as a
> patch"
> > >
> > > the
> > >
> > > > >> file ? As you talk about "a file in directories that does not
> exist
> > > > >> previously", I guess you mean a file from the "pending translate"
> > > > >> module.
> > > > >>
> > > > >> Anyway, are you interest to translate the editor into your native
> > > > >> language ? ;)
> > > > >
> > > > > I tried to translate a new file from ennglish to persian and save
> the
> > > > > file. Currently I 

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

Hi again,
There seems to be a problem with the way online editor handles error pages.

Whenever I try to save a document with error, an error page is opened and
then if you solve some errors but not all of them and try to save it again
and the error page is open the saving fails but if you first close the error
page and then save it everything is okay.

Best,
Pedram

On Wed, Mar 17, 2010 at 2:06 AM, yannick  wrote:

> Le Mardi 16 Mars 2010 21:49:19, pedram salehpoor a écrit :
> > At last I found the source of problem!
> >
> > When the encoding of the original english file is iso-8859-1 and I use
> > Utf-8 in my documents without changing the encoding the problem arises
> > when I try saving the files
>
> I just reproduice it. We see the error output if you use tools like Firebug
> with Firefox.
>
> Anyway, I will send a "valid" error in this case.
> Fix will comming soon ;)
>
> >
> > Pedram.
> >
> >
> > On Tue, Mar 16, 2010 at 4:43 PM, pedram salehpoor <
> >
> > pedram.salehp...@gmail.com> wrote:
> > > On Tue, Mar 16, 2010 at 4:31 PM, TORRES yannick
> wrote:
> > >> Hi Pedram,
> > >>
> > >> 2010/3/16 pedram salehpoor 
> > >>
> > >> Hi, I'm encountering some problems in the editor.
> > >>
> > >>> The editor begins two reload itself without letting me to save
> anything
> > >>> and the data is lost.
> > >>>
> > >>> When the editor tries to save new files in the directories that does
> > >>> not exist previously it enters a loop and never ends its work and
> > >>> after reloading the page there is a commit pending and the contents
> > >>> are lost and it will not show the content that has been saved and if
> > >>> you cancel the change again the english content can't be viewed until
> > >>> you completely reload the page.
> > >>>
> > >>> Am I doing anything wrong or what should I do?
> > >>
> > >> I'm going to try to reproduice it tonight and tell you more once it's
> > >> done.
> > >> Just one question : you try to "save" the file or "save as a patch"
> the
> > >> file ? As you talk about "a file in directories that does not exist
> > >> previously", I guess you mean a file from the "pending translate"
> > >> module.
> > >>
> > >> Anyway, are you interest to translate the editor into your native
> > >> language ? ;)
> > >
> > > I tried to translate a new file from ennglish to persian and save the
> > > file. Currently I have one of those kinds of files  on my commit
> pending
> > > list If you had time you can take a look at it.
> > >
> > > I'll be happy to translate the editor into my own language.
> > >
> > > Pedram
> > >
> > >>> Best
> > >>> Pedram
> > >>>
> > >>> On Mon, Mar 15, 2010 at 7:19 PM, yannick
> wrote:
> > >>>> Fixed : http://svn.php.net/viewvc?view=revision&revision=296248
> > >>>>
> > >>>> I have updated manually edit.php.net, so you can view the result
> right
> > >>>> now.
> > >>>>
> > >>>> Best,
> > >>>> Yannick
> > >>>>
> > >>>> Le Lundi 15 Mars 2010 07:54:36, yannick a écrit :
> > >>>> > Hi Yago,
> > >>>> >
> > >>>> > I can't find a quick fix for this but I have arrive to reproduice
> it
> > >>>> > locally.
> > >>>> >
> > >>>> > I will fix it when I'm going back home after work ;)
> > >>>> >
> > >>>> > Best,
> > >>>> > Yannick
> > >>>> >
> > >>>> > Le Lundi 15 Mars 2010 06:41:44, Yago Ferrer a écrit :
> > >>>> > > Here another bug:
> > >>>> > >
> > >>>> > > login: as anonymous or VCS
> > >>>> > > Language: Spanish
> > >>>> > >
> > >>>> > > If you go to Pending for commit,
> > >>>> > > right click in the file imagerotate.xml
> > >>>> > > click in View Diff it and shows an blank page it should show the
> > >>>>
> > >>>> changes
> > >>>>
> > >>>> > > between the copy in the repository
> > >>>> > > and the copy pending to commit.
> > >>>> > >
> > >>>> > > Thanks!
>

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

At last I found the source of problem!

When the encoding of the original english file is iso-8859-1 and I use Utf-8
in my documents without changing the encoding the problem arises when I try
saving the files

Pedram.


On Tue, Mar 16, 2010 at 4:43 PM, pedram salehpoor <
pedram.salehp...@gmail.com> wrote:

>
>
> On Tue, Mar 16, 2010 at 4:31 PM, TORRES yannick 
> wrote:
>
>> Hi Pedram,
>>
>> 2010/3/16 pedram salehpoor 
>>
>> Hi, I'm encountering some problems in the editor.
>>>
>>> The editor begins two reload itself without letting me to save anything
>>> and the data is lost.
>>>
>>> When the editor tries to save new files in the directories that does not
>>> exist previously it enters a loop and never ends its work and after
>>> reloading the page there is a commit pending and the contents are lost and
>>> it will not show the content that has been saved and if you cancel the
>>> change again the english content can't be viewed until you completely reload
>>> the page.
>>>
>>> Am I doing anything wrong or what should I do?
>>>
>>
>> I'm going to try to reproduice it tonight and tell you more once it's
>> done.
>> Just one question : you try to "save" the file or "save as a patch" the
>> file ? As you talk about "a file in directories that does not exist
>> previously", I guess you mean a file from the "pending translate" module.
>>
>> Anyway, are you interest to translate the editor into your native language
>> ? ;)
>>
> I tried to translate a new file from ennglish to persian and save the file.
> Currently I have one of those kinds of files  on my commit pending list If
> you had time you can take a look at it.
>
> I'll be happy to translate the editor into my own language.
>
> Pedram
>
>
>>
>>>
>>> Best
>>> Pedram
>>>
>>>
>>> On Mon, Mar 15, 2010 at 7:19 PM, yannick wrote:
>>>
>>>> Fixed : http://svn.php.net/viewvc?view=revision&revision=296248
>>>>
>>>> I have updated manually edit.php.net, so you can view the result right
>>>> now.
>>>>
>>>> Best,
>>>> Yannick
>>>>
>>>> Le Lundi 15 Mars 2010 07:54:36, yannick a écrit :
>>>> > Hi Yago,
>>>> >
>>>> > I can't find a quick fix for this but I have arrive to reproduice it
>>>> > locally.
>>>> >
>>>> > I will fix it when I'm going back home after work ;)
>>>> >
>>>> > Best,
>>>> > Yannick
>>>> >
>>>> > Le Lundi 15 Mars 2010 06:41:44, Yago Ferrer a écrit :
>>>> > > Here another bug:
>>>> > >
>>>> > > login: as anonymous or VCS
>>>> > > Language: Spanish
>>>> > >
>>>> > > If you go to Pending for commit,
>>>> > > right click in the file imagerotate.xml
>>>> > > click in View Diff it and shows an blank page it should show the
>>>> changes
>>>> > > between the copy in the repository
>>>> > > and the copy pending to commit.
>>>> > >
>>>> > > Thanks!
>>>>
>>>
>>>
>>
>

Re: [PHP-DOC] italian documentation project

[pedram salehpoor]

Hi,
I think if you use our new online editor it may help you.

edit.php.net

you can see them online on

svn.php.net

and/or you can download it using a SVN client.

If you need anymore help feel free to ask.

Pedram

On Tue, Mar 16, 2010 at 5:41 PM, Michele Carino
wrote:

>  Actually the situation of the italian php documentation project is stuck.
> I can't find istruction to access in readonly to the repository, and get
> the material written already to continue the work.
> --
> Hotmail: Trusted email with Microsoft’s powerful SPAM protection. Sign up
> now. 
>

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

On Tue, Mar 16, 2010 at 4:31 PM, TORRES yannick wrote:

> Hi Pedram,
>
> 2010/3/16 pedram salehpoor 
>
> Hi, I'm encountering some problems in the editor.
>>
>> The editor begins two reload itself without letting me to save anything
>> and the data is lost.
>>
>> When the editor tries to save new files in the directories that does not
>> exist previously it enters a loop and never ends its work and after
>> reloading the page there is a commit pending and the contents are lost and
>> it will not show the content that has been saved and if you cancel the
>> change again the english content can't be viewed until you completely reload
>> the page.
>>
>> Am I doing anything wrong or what should I do?
>>
>
> I'm going to try to reproduice it tonight and tell you more once it's done.
> Just one question : you try to "save" the file or "save as a patch" the
> file ? As you talk about "a file in directories that does not exist
> previously", I guess you mean a file from the "pending translate" module.
>
> Anyway, are you interest to translate the editor into your native language
> ? ;)
>
I tried to translate a new file from ennglish to persian and save the file.
Currently I have one of those kinds of files  on my commit pending list If
you had time you can take a look at it.

I'll be happy to translate the editor into my own language.

Pedram


>
>>
>> Best
>> Pedram
>>
>>
>> On Mon, Mar 15, 2010 at 7:19 PM, yannick wrote:
>>
>>> Fixed : http://svn.php.net/viewvc?view=revision&revision=296248
>>>
>>> I have updated manually edit.php.net, so you can view the result right
>>> now.
>>>
>>> Best,
>>> Yannick
>>>
>>> Le Lundi 15 Mars 2010 07:54:36, yannick a écrit :
>>> > Hi Yago,
>>> >
>>> > I can't find a quick fix for this but I have arrive to reproduice it
>>> > locally.
>>> >
>>> > I will fix it when I'm going back home after work ;)
>>> >
>>> > Best,
>>> > Yannick
>>> >
>>> > Le Lundi 15 Mars 2010 06:41:44, Yago Ferrer a écrit :
>>> > > Here another bug:
>>> > >
>>> > > login: as anonymous or VCS
>>> > > Language: Spanish
>>> > >
>>> > > If you go to Pending for commit,
>>> > > right click in the file imagerotate.xml
>>> > > click in View Diff it and shows an blank page it should show the
>>> changes
>>> > > between the copy in the repository
>>> > > and the copy pending to commit.
>>> > >
>>> > > Thanks!
>>>
>>
>>
>

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

Hi, I'm encountering some problems in the editor.

The editor begins two reload itself without letting me to save anything and
the data is lost.

When the editor tries to save new files in the directories that does not
exist previously it enters a loop and never ends its work and after
reloading the page there is a commit pending and the contents are lost and
it will not show the content that has been saved and if you cancel the
change again the english content can't be viewed until you completely reload
the page.

Am I doing anything wrong or what should I do?

Best
Pedram

On Mon, Mar 15, 2010 at 7:19 PM, yannick  wrote:

> Fixed : http://svn.php.net/viewvc?view=revision&revision=296248
>
> I have updated manually edit.php.net, so you can view the result right
> now.
>
> Best,
> Yannick
>
> Le Lundi 15 Mars 2010 07:54:36, yannick a écrit :
> > Hi Yago,
> >
> > I can't find a quick fix for this but I have arrive to reproduice it
> > locally.
> >
> > I will fix it when I'm going back home after work ;)
> >
> > Best,
> > Yannick
> >
> > Le Lundi 15 Mars 2010 06:41:44, Yago Ferrer a écrit :
> > > Here another bug:
> > >
> > > login: as anonymous or VCS
> > > Language: Spanish
> > >
> > > If you go to Pending for commit,
> > > right click in the file imagerotate.xml
> > > click in View Diff it and shows an blank page it should show the
> changes
> > > between the copy in the repository
> > > and the copy pending to commit.
> > >
> > > Thanks!
>

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

Oh thanks again. This editor has made everything so much easier.

Pedram

On Sun, Mar 14, 2010 at 4:33 PM, yannick  wrote:

> Le Dimanche 14 Mars 2010 13:58:32, pedram salehpoor a écrit :
> > Thanks so editors data are not online and they update periodically?
>
> Yes,
>
> editor code is updated from svn multiple time per day, and data
> documentation
> just one time per day.
>
> Here, to view the result of this commit, we must wait for both ;)
>
> >
> >
> > Pedram
> >
> > On Sun, Mar 14, 2010 at 4:25 PM, yannick 
> wrote:
> > > Le Dimanche 14 Mars 2010 13:52:21, pedram salehpoor a écrit :
> > > > The number of translated files are not shown correctly
> > > >
> > > > And the problem of the total size persists.
> > >
> > > Please, just wait until the edit.php.net will be synched with SVN &
> data
> > > will
> > > be updated.
> > >
> > > > pedram
> > > >
> > > > On Sun, Mar 14, 2010 at 3:57 PM, yannick 
> > >
> > > wrote:
> > > > > Le Samedi 13 Mars 2010 23:02:09, pedram salehpoor a écrit :
> > > > > > Thanks That's strange I'm sure that I created the file in the
> root
> > >
> > > but
> > >
> > > > > it's
> > > > >
> > > > > > not there!
> > > > > > I should create it again.
> > > > > >
> > > > > > And I think there is problem with the total size of files in the
> > > > > > main
> > > > >
> > > > > page.
> > > > >
> > > > > > It shows 819 although the size is more than 2.
> > > > >
> > > > > Just fix this part :
> > > > >
> > > > > http://svn.php.net/viewvc?view=revision&revision=296180
> > > > >
> > > > > Best,
> > > > > Yannick
> > > > >
> > > > > > Pedram
> > > > > >
> > > > > > On Sun, Mar 14, 2010 at 1:25 AM, yannick <
> yannick.tor...@gmail.com>
> > > > >
> > > > > wrote:
> > > > > > > Le Samedi 13 Mars 2010 22:01:33, pedram salehpoor a écrit :
> > > > > > > > Well
> > > > > > > > A question occurred to me! why my name is not in the
> > > > > > > > translators
> > >
> > > of
> > >
> > > > > > > persian
> > > > > > >
> > > > > > > > language and the names that it shows as translators I have
> > > > > > > > never seen the files they h
> > > > > > > >
> > > > > > > > Pedram
> > > > > > >
> > > > > > > This list is extract from translation.xml witch is on the root
> of
> > >
> > > the
> > >
> > > > > > > translated folder.
> > > > > > >
> > > > > > > Make sur you are in ;)
> > > > > > >
> > > > > > > Best,
> > > > > > > Yannick
>

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

Thanks so editors data are not online and they update periodically?


Pedram

On Sun, Mar 14, 2010 at 4:25 PM, yannick  wrote:

> Le Dimanche 14 Mars 2010 13:52:21, pedram salehpoor a écrit :
> > The number of translated files are not shown correctly
> >
> > And the problem of the total size persists.
>
> Please, just wait until the edit.php.net will be synched with SVN & data
> will
> be updated.
>
> >
> >
> > pedram
> >
> > On Sun, Mar 14, 2010 at 3:57 PM, yannick 
> wrote:
> > > Le Samedi 13 Mars 2010 23:02:09, pedram salehpoor a écrit :
> > > > Thanks That's strange I'm sure that I created the file in the root
> but
> > >
> > > it's
> > >
> > > > not there!
> > > > I should create it again.
> > > >
> > > > And I think there is problem with the total size of files in the main
> > >
> > > page.
> > >
> > > > It shows 819 although the size is more than 2.
> > >
> > > Just fix this part :
> > >
> > > http://svn.php.net/viewvc?view=revision&revision=296180
> > >
> > > Best,
> > > Yannick
> > >
> > > > Pedram
> > > >
> > > > On Sun, Mar 14, 2010 at 1:25 AM, yannick 
> > >
> > > wrote:
> > > > > Le Samedi 13 Mars 2010 22:01:33, pedram salehpoor a écrit :
> > > > > > Well
> > > > > > A question occurred to me! why my name is not in the translators
> of
> > > > >
> > > > > persian
> > > > >
> > > > > > language and the names that it shows as translators I have never
> > > > > > seen the files they h
> > > > > >
> > > > > > Pedram
> > > > >
> > > > > This list is extract from translation.xml witch is on the root of
> the
> > > > > translated folder.
> > > > >
> > > > > Make sur you are in ;)
> > > > >
> > > > > Best,
> > > > > Yannick
>

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

The number of translated files are not shown correctly

And the problem of the total size persists.


pedram


On Sun, Mar 14, 2010 at 3:57 PM, yannick  wrote:

> Le Samedi 13 Mars 2010 23:02:09, pedram salehpoor a écrit :
> > Thanks That's strange I'm sure that I created the file in the root but
> it's
> > not there!
> > I should create it again.
> >
> > And I think there is problem with the total size of files in the main
> page.
> > It shows 819 although the size is more than 2.
>
> Just fix this part :
>
> http://svn.php.net/viewvc?view=revision&revision=296180
>
> Best,
> Yannick
>
> >
> > Pedram
> >
> > On Sun, Mar 14, 2010 at 1:25 AM, yannick 
> wrote:
> > > Le Samedi 13 Mars 2010 22:01:33, pedram salehpoor a écrit :
> > > > Well
> > > > A question occurred to me! why my name is not in the translators of
> > >
> > > persian
> > >
> > > > language and the names that it shows as translators I have never seen
> > > > the files they h
> > > >
> > > > Pedram
> > >
> > > This list is extract from translation.xml witch is on the root of the
> > > translated folder.
> > >
> > > Make sur you are in ;)
> > >
> > > Best,
> > > Yannick
>

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

And I forgot in persian language page.

On Sun, Mar 14, 2010 at 1:43 AM, pedram salehpoor <
pedram.salehp...@gmail.com> wrote:

> In the fourth line in Summary:
>   number of files  percent of files  size of files  percent of
> files
> total9260100%819100%
>
> The size should be more than 2.
>
>
>
> On Sun, Mar 14, 2010 at 1:38 AM, yannick  wrote:
>
>> Perhaps there is a problem with the langue code...
>>
>> Witch it should be for Persian ?
>>
>> Le Samedi 13 Mars 2010 23:02:09, pedram salehpoor a écrit :
>> > Thanks That's strange I'm sure that I created the file in the root but
>> it's
>> > not there!
>> > I should create it again.
>> >
>> > And I think there is problem with the total size of files in the main
>> page.
>> > It shows 819 although the size is more than 2.
>> >
>> > Pedram
>> >
>> > On Sun, Mar 14, 2010 at 1:25 AM, yannick 
>> wrote:
>> > > Le Samedi 13 Mars 2010 22:01:33, pedram salehpoor a écrit :
>> > > > Well
>> > > > A question occurred to me! why my name is not in the translators of
>> > >
>> > > persian
>> > >
>> > > > language and the names that it shows as translators I have never
>> seen
>> > > > the files they h
>> > > >
>> > > > Pedram
>> > >
>> > > This list is extract from translation.xml witch is on the root of the
>> > > translated folder.
>> > >
>> > > Make sur you are in ;)
>> > >
>> > > Best,
>> > > Yannick
>>
>
>

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

In the fourth line in Summary:
  number of files  percent of files  size of files  percent of files
total9260100%819100%

The size should be more than 2.


On Sun, Mar 14, 2010 at 1:38 AM, yannick  wrote:

> Perhaps there is a problem with the langue code...
>
> Witch it should be for Persian ?
>
> Le Samedi 13 Mars 2010 23:02:09, pedram salehpoor a écrit :
> > Thanks That's strange I'm sure that I created the file in the root but
> it's
> > not there!
> > I should create it again.
> >
> > And I think there is problem with the total size of files in the main
> page.
> > It shows 819 although the size is more than 2.
> >
> > Pedram
> >
> > On Sun, Mar 14, 2010 at 1:25 AM, yannick 
> wrote:
> > > Le Samedi 13 Mars 2010 22:01:33, pedram salehpoor a écrit :
> > > > Well
> > > > A question occurred to me! why my name is not in the translators of
> > >
> > > persian
> > >
> > > > language and the names that it shows as translators I have never seen
> > > > the files they h
> > > >
> > > > Pedram
> > >
> > > This list is extract from translation.xml witch is on the root of the
> > > translated folder.
> > >
> > > Make sur you are in ;)
> > >
> > > Best,
> > > Yannick
>

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

Thanks That's strange I'm sure that I created the file in the root but it's
not there!
I should create it again.

And I think there is problem with the total size of files in the main page.
It shows 819 although the size is more than 2.

Pedram

On Sun, Mar 14, 2010 at 1:25 AM, yannick  wrote:

> Le Samedi 13 Mars 2010 22:01:33, pedram salehpoor a écrit :
> > Well
> > A question occurred to me! why my name is not in the translators of
> persian
> > language and the names that it shows as translators I have never seen the
> > files they h
> >
> > Pedram
>
> This list is extract from translation.xml witch is on the root of the
> translated folder.
>
> Make sur you are in ;)
>
> Best,
> Yannick
>

Re: [PHP-DOC] the online documentation editor

[pedram salehpoor]

hmm...
I don't know should I call this a bug but the following sentence has
spelling errors:

"The file * fa/language/oop5/visibility.xml* contains some tab caracters.
The editor have replace it with space caracters."

It should be Characters I think not Caracters.

Pedram

On Fri, Mar 12, 2010 at 4:53 AM, Philip Olson  wrote:

> Hello everyone,
>
> Before we go public with the online documentation editor, let's all make a
> real effort to try it out. Please break it, and please use it the next time
> (or three) you make a commit. We don't need test commits (it works) but real
> world usage. This applies to both translations and English.
>
> There are a few bug reports and more should exist. Feature requests are
> also encouraged.
>
> The editor is here:
>  - http://edit.php.net/
>
> Documentation for it:
>  - http://wiki.php.net/doc/editor/
>
> The source code:
>  - http://svn.php.net/viewvc/web/doc-editor/trunk/
>
> Notes:
>  - Anyone (even anonymous) can create patches
>  - Those with karma can commit their own and other peoples patches
>  - Please check diffs before commit, as there may be whitespace bugs
>  - The PEAR manual is also selectable, but choose PHP ;)
>
> Eventually we'll ask the world to create patches using this and who knows
> where we'll go from there, but likely a good place.
>
> Regards,
> Philip
>
>
>

[PHP-DOC] the online documentation editor

[pedram salehpoor]

Well
A question occurred to me! why my name is not in the translators of persian
language and the names that it shows as translators I have never seen the
files they h

Pedram

Re: [PHP-DOC] SVN Account Request: hamidsoltani

[pedram salehpoor]

On Tue, Feb 23, 2010 at 5:03 PM, Hamid Soltani wrote:

> Translating Documentation
>

I think it is better if you first give some of the pages you translated and
then if you wanted to continue you can do it and get SVN account.

Re: [PHP-DOC] Getting started with documentation contribution?

[pedram salehpoor]

HI Dan,

You can start by reading and giving patches and solve problems things like
that. After sometime you can request access to SVN and begin to commit your
changes yourself. Hope to see you soon as I was absent for a long time
myself.

Pedram

On Thu, Oct 8, 2009 at 2:46 PM, Dan  wrote:

> Hi all,
> I'm sure this is a very common question, so apologies if it is. I'm
> interested in contributing to the PHP documentation, and was wondering where
> would I get started? Are documentation tasks assigned, or do I just request
> access and go for it?
>
> Thanks
>
> Dan Cryer
>
>

Re: [PHP-DOC] Translating php manual into Persian

[pedram salehpoor]

dear Daniel
We better to continue our discussion in the dedicated mailing list of
persian translation DOC-FA.
But have you worked with any extension of PHP. The main part of PHP
documentation is its documentation of extensions. The other parts are
relatively translated.
If you are able to translate some of documentation of extensions that will
be a great help.

Regards.
Pedram

On Fri, Jul 31, 2009 at 2:20 AM, Daniel Rahmanzadeh wrote:

> Dear Pedram,
> Please let me know which part of manual should i translate and send to you.
> Regards,
> Dan
>
> On Thu, Jul 16, 2009 at 12:08 AM, Daniel Rahmanzadeh
> wrote:
> > Hi,
> > Unfortunately I don't have any translations currently about PHP. But i
> > have accomplished something for java that can be found here:
> > http://www.mobilejava.mobi
> > Regards,
> > Dan
> > On Wed, 2009-07-15 at 09:41 +0430, pedram salehpoor wrote:
> >> Hi dear daniel
> >> The translations are in http://svn.php.net/viewvc/phpdoc/fa/trunk/ and
> >> they are going on.
> >> There will be some changes in translation files of phpdoc so I have
> >> put a hold on committing new translations for now until changes are
> >> complete.
> >> So if you would like to, please send me some of your translations.
> >>
> >> Regards.
> >> Pedram
> >>
> >> On Tue, Jul 14, 2009 at 9:15 PM, Daniel Rahmanzadeh 
> >> wrote:
> >> hi there,
> >> I'd like to help translate php manual into persian. there's a
> >> page for
> >> Persian manual but unfortunately no part is translated. I want
> >> to know
> >> how to start it. Maybe i need a quick start guide or HOWTO.
> >> Thanks in advance,
> >> Daniel
> >>
> >
> >
>
>
>
> --
> Daniel Rahmanzadeh
>

[PHP-DOC] PO files progress

[pedram salehpoor]

Hi
I wanted to know how the changes for PO files are progressing and if there
is anything that I can do to ease the change?

Regards.
Pedram Salehpoor

Re: [PHP-DOC] Translating php manual into Persian

[pedram salehpoor]

Hi dear daniel
The translations are in http://svn.php.net/viewvc/phpdoc/fa/trunk/ and they
are going on.
There will be some changes in translation files of phpdoc so I have put a
hold on committing new translations for now until changes are complete.
So if you would like to, please send me some of your translations.

Regards.
Pedram

On Tue, Jul 14, 2009 at 9:15 PM, Daniel Rahmanzadeh wrote:

> hi there,
> I'd like to help translate php manual into persian. there's a page for
> Persian manual but unfortunately no part is translated. I want to know
> how to start it. Maybe i need a quick start guide or HOWTO.
> Thanks in advance,
> Daniel
>

Re: [PHP-DOC] "ezmlm warning" why

[pedram salehpoor]

On Thu, Jun 4, 2009 at 9:45 PM, Philip Olson  wrote:

>
>  Hi everyone
 I have received a "ezmlm warning". It says my email address bounces back
 messages or something like that.
 What is the meaning of this? And if there is an error what should I do
 to solve it?

>>>
>>>
>>> Greetings Pedram,
>>>
>>> I'm unsure what the problem is (or was) but I also suffered from it...
>>> but it seems fine now.
>>>
>>
>
>  There was some sort of illegal attachment sent. It was probably rejected
>> by most servers and thus re ping to see if the email address was dead.
>>
>> That's my best guess.
>>
>
> Maybe that was part of it, but yesterday I didn't receive several valid
> emails from several php.net lists. The ezmlm warning messages referred to
> missed messages, and emitted permanent errors like:
>
> - phi...@roshambo.org (while not connected): 554 5.4.4 Domain Lookup
> Failed
> - phi...@roshambo.org (reading BANNER): 554 5.4.4 Domain Lookup Failed
>
> The problem appeared php.net specific because emails from other locations
> were making it through, but at the same time I dismissed it as a temporary
> issue (and my total lack of knowledge on the subject doesn't help).
>
>
>
> I also think that the problem is php.net specific. At first I thought the
problem is from my spamming rules but after that I saw no other
irregularities.
Sorry I'm encountering some problems on my comp.
Regards.
Pedram

Re: [PHP-DOC] "ezmlm warning" why

[pedram salehpoor]

On Thu, Jun 4, 2009 at 9:45 PM, Philip Olson  wrote:

>
>  Hi everyone
 I have received a "ezmlm warning". It says my email address bounces back
 messages or something like that.
 What is the meaning of this? And if there is an error what should I do
 to solve it?

>>>
>>>
>>> Greetings Pedram,
>>>
>>> I'm unsure what the problem is (or was) but I also suffered from it...
>>> but it seems fine now.
>>>
>>
>
>  There was some sort of illegal attachment sent. It was probably rejected
>> by most servers and thus re ping to see if the email address was dead.
>>
>> That's my best guess.
>>
>
> Maybe that was part of it, but yesterday I didn't receive several valid
> emails from several php.net lists. The ezmlm warning messages referred to
> missed messages, and emitted permanent errors like:
>
> - phi...@roshambo.org (while not connected): 554 5.4.4 Domain Lookup
> Failed
> - phi...@roshambo.org (reading BANNER): 554 5.4.4 Domain Lookup Failed
>
> The problem appeared php.net specific because emails from other locations
> were making it through, but at the same time I dismissed it as a temporary
> issue (and my total lack of knowledge on the subject doesn't help).
>
>
> I also think that the problem is php.net specific. At first I thought the
problem is from my spamming rules but after that I saw no other
irregularities.

Regards.
Pedram

[PHP-DOC] "ezmlm warning" why

[pedram salehpoor]

Hi everyone
I have received a "ezmlm warning". It says my email address bounces back
messages or something like that.
What is the meaning of this? And if there is an error what should I do to
solve it?

Regards.
P. Salehpoor

Re: [PHP-DOC] New Persian (Farsi) Translation

[pedram salehpoor]

Hi majid
That's a little harsh answer. Don't you think so?;)
The problem stopping me from uploading has been solved only recently. So I
was getting ready to begin the work next week.
As a matter of fact team work is the best.


pedram

On Sun, May 17, 2009 at 1:49 PM, pedram salehpoor <
pedram.salehp...@gmail.com> wrote:

> Hi majid
>
> It is not abandoned. I am the one started it so if you would like to
> participate please let me know.
>
> Somehow I got a little busy and unable to upload the things I translated.
>
> I am looking forward to your answer.
>
> Regards.
> P. Salehpoor
>
>
>
> On Sat, May 16, 2009 at 9:53 PM, majid foladpour wrote:
>
>> Hi all,
>>
>> I would like to start a new Persian translation.
>>
>> The current translation has apparently been abandoned. The last update
>> on the csv dates back to Dec 18 2008, and the total text translated is
>> very little.
>>
>> Please let me know how I should proceed.
>>
>> Thanks,
>> Majid
>>
>
>

Re: [PHP-DOC] New Persian (Farsi) Translation

[pedram salehpoor]

Hi majid

It is not abandoned. I am the one started it so if you would like to
participate please let me know.

Somehow I got a little busy and unable to upload the things I translated.

I am looking forward to your answer.

Regards.
P. Salehpoor


On Sat, May 16, 2009 at 9:53 PM, majid foladpour wrote:

> Hi all,
>
> I would like to start a new Persian translation.
>
> The current translation has apparently been abandoned. The last update
> on the csv dates back to Dec 18 2008, and the total text translated is
> very little.
>
> Please let me know how I should proceed.
>
> Thanks,
> Majid
>

[PHP-DOC] "iso-8859-1" and "utf-8"

[pedram salehpoor]

Hello everyone
Usually during my translation of phpdoc tp persian I encountered files with
different encoding. Some of them has "iso-8859-1" encoding and other has
"utf-8". Is there any difference using them and one is prefered? I use
"utf-8" as a default encoding. Will I encounter any problem?

 Regards.
 Pedram

[PHP-DOC] Re: problem building phpdoc on windows

[pedram salehpoor]

On Tue, Jun 24, 2008 at 7:48 PM, pedram salehpoor <
[EMAIL PROTECTED]> wrote:

> hello everyone
> Sorry but again I encountered a new error on windows building phpdoc with
> php 5.2.7-dev june 20 2008.
> I had no problem building it Friday.
>
> Now when I try to build it my php exits with "unhandled win32 exception in
> php.exe" on line 516
>
> "$didLoad = $dom->load(realpath("{$ac['srcdir']}/manual.xml"),
> $LIBXML_OPTS);"
>
> Does it need special security permission?
>
> PROBLEM UPDATE:

The problem occurred during this line and to somehow php.exe finished my
virtual space and I got an error of low space and after ending it, I had
800MB free on my hard drive.

[PHP-DOC] problem building phpdoc on windows

[pedram salehpoor]

hello everyone
Sorry but again I encountered a new error on windows building phpdoc with
php 5.2.7-dev june 20 2008.
I had no problem building it Friday.

Now when I try to build it my php exits with "unhandled win32 exception in
php.exe" on line 516

"$didLoad = $dom->load(realpath("{$ac['srcdir']}/manual.xml"),
$LIBXML_OPTS);"

Does it need special security permission?

  Regards.
  Pedram

Re: [PHP-DOC] problem building phpdoc on windows

[pedram salehpoor]

> Ah. You need to upgrade your phd. See changes 1.50 to 1.53
> > (http://cvs.php.net/viewvc.cgi/phpdoc/configure.php?r1=1.50&r2=1.53)
>
> Just to be clear: phpdoc/ is _not_ PhD. configure.php is not part of PhD.
> The only PhD related stuff is under the phd/ CVS module.
>
> To be more precise my problem arise from
 http://cvs.php.net/viewvc.cgi/phpdoc/configure.php?r1=1.54&r2=1.52
I had no problem in 1.52 version of configure.php but suddenly the problem
arose. From our previous discussion you said I should download latest
compilation of PHP and the problem is spaces in commands and windows command
line does not accept them and after getting a june 2 compilation 5.2.7-dev
the problem got solved but this time error come up with the same symptoms in
php configure.php --with-lang=fa
So I got a june 20 compilation snap and after reinstalling completely the
problem was solved I don't use phd very often because our translation has
started recently.

   Regards.
   Pedram

Re: [PHP-DOC] problem building phpdoc on windows

[pedram salehpoor]

>
> Ah. You need to upgrade your phd. See changes 1.50 to 1.53 (
> http://cvs.php.net/viewvc.cgi/phpdoc/configure.php?r1=1.50&r2=1.53)
>
OH! I upgraded it. Thank you very much.

Regards.
Pedram

Re: [PHP-DOC] problem building phpdoc on windows

[pedram salehpoor]

On Sat, Jun 21, 2008 at 5:56 AM, Hannes Magnusson <
[EMAIL PROTECTED]> wrote:

> On Fri, Jun 20, 2008 at 19:51, pedram salehpoor
> <[EMAIL PROTECTED]> wrote:
> > hello everyone
> > I tried to build phpdoc with my php 2-7-dev 2 june 2008. But it failed.
> The
> > other time when it failed I got latest version (2 june 2008) and it
> solved
> > my problem but this time latest version did not solved my problem. It
> builds
> > with older configure.php which I got on june 4 without problem. But with
> new
> > one it stucks. Which version should I get to solve these problems?
>
> You should either get the latest _stable_ version of PHP (5.2.x) or
> get a newer PHP5.3.0 snapshot.
> There were some changes in PHP5.3 in which we had to adept to, so as
> long as you are running either PHP5.2 og PHP5.3 _latest_ everything
> should be fine, if not, please post full error details so we can
> troubleshoot it.
>
> -Hannes
>

The problem was because of change of line 121
from
if (is_windows() && phpversion() < '5.2.7')
to
if (is_windows() && phpversion() < '5.3')
in configure.php.
I got latest version and after reinstalling it completely my problem was
solved.

 Regards.
 Pedram

[PHP-DOC] problem building phpdoc on windows

[pedram salehpoor]

hello everyone
I tried to build phpdoc with my php 2-7-dev 2 june 2008. But it failed. The
other time when it failed I got latest version (2 june 2008) and it solved
my problem but this time latest version did not solved my problem. It builds
with older configure.php which I got on june 4 without problem. But with new
one it stucks. Which version should I get to solve these problems?

And stable version which I downloaded encounters session problems which was
solved when I got latest version which was a dev.

   Best Regards
   Pedram

Re: [PHP-DOC] Machine-readable PHP documentation?

[pedram salehpoor]

On Tue, Jun 3, 2008 at 4:23 PM, Edward Z. Yang <
[EMAIL PROTECTED]> wrote:

> Ben Dilts wrote:
> > I can't seem to find information on how to make complete XML files of
> > the reference docs.  The en/reference/*/functions/*.xml files are not
> > actually valid XML, as they don't have a DOCTYPE and don't define all
> > the custom XML entities they use.
> >
> > How do I transform these sources into complete, valid XML documents?
>
> Use configure.php. An outstanding project is to make all of PHP's
> documentation sources standalone valid XML files, but for now, you'll
> need to glom them all together.
>
> It seems really an interesting project for making all of them standalone
> valid XML files.Where should we start it and what benefits It will have for
> phpdoc?
>Regards.
>Pedram
>

Re: [PHP-DOC] problem building phpdoc

[pedram salehpoor]

Hello Richard

Thank that solved my problem!

Re: [PHP-DOC] problem building phpdoc

[pedram salehpoor]

>
> What version of PHP are you using? From the command line can you type
> php -v and cut and paste the entire output?
>
> I can only guess you are on a 5.3.0-dev which was built before 2008-05-29.
>
> The issue is with windows cmd.exe not liking running programs with
> spaces in program name and params ...
>
> cmd.exe /c "C:\Program Files\Internet Explorer\iexplore.exe"
> "http://www.google.com/search?q=Richard Quadling"
>
> for example.
>
> The userland fix (and the one you have as working version) is to wrap
> the program and params in another set of "" ...
>
> e.g.
>
> cmd.exe /c ""C:\Program Files\Internet Explorer\iexplore.exe"
> "http://www.google.com/search?q=Richard Quadling""
>
>
> But if you write code for both *nix and Win32, having this
> inconsistency is a pain.
>
> So it was fixed in 5.2.7-dev, 5.3.0-dev and head on 2008-05-29
>
> So, after the patch, the latest release of PHP would break windows builds.
>
> phpdoc was patched.
>
> But requires newer cvs/snapshot of PHP _IF_ you are a -dev release.
>
> If using 5.2.6 or earlier, then all should be ok.
>
> Richard.


Hello Richard

I'm using php 5.2.7-dev (built: may 20 2008 04:04:54).

Which version should I get now?

Thanks In advance.

   Regards.
   Pedram

[PHP-DOC] problem building phpdoc

[pedram salehpoor]

Hello everyone
I tried to build my latest phpdoc I got through CVS but it gave me problem
in "version.ent" with "Startingtag: invalid element name". What's causing
it?

It stopped me checking translation files to commit.

 Regards.
 Pedram

[PHP-DOC] missing examples for databases

[pedram salehpoor]

hi evereybody
I was looking at missing examples for different databases and they were so
similar. Similar functions are documented for Mysql database so I think it's
better to have unified examples (with minor changes if needed). If it's
decided to have unified examples I can help with some of theses databases I
have worked with like MSSQL.

   Regards.
   Pedram

[PHP-DOC] problem with configure.php in phpdoc

[pedram salehpoor]

hi everybody
I tried to use configure.php on my latest phpdoc version I got through
anonymous cvs account but it returned with error "element variable is not
declared in entry list of possible children" and in details the problem is
in en/reference/phar/constants.xml.
How should I use configure.php for it correctly.

Thanks in advance
  Regards.

[PHP-DOC] new translation to persian language

[pedram salehpoor]

hi,
I want to start new translation to persian language.
I need a cvs account to do this. I'm working using php from 2005 and the
lack of this doc in my language restricts programmers a lot.


Thank you very much.

Pedram Salehpoor

[PHP-DOC] starting new translation, needing approval

[pedram salehpoor]

hi,
I want to start a new translation of doc to persian. Please approve it and I
will be able to get a cvs account.
We have a lot of php scripters who speak this language but because of
language they can not use doc for their work. So if you approve it I will
begin translation of doc to this language.

Thanks in advance

Pedram Salehpoor

[PHP-DOC] Is there any translation of doc to persian language?

[pedram salehpoor]

hi
I wanted to start a new translation to persian language.
Is there any translation team for this language?


Thank you very much.


Pedram Salehpoor