Re: [PHP-DOC] Patch for documentation
On Tue, Aug 26, 2008 at 16:48, Stefan Hinz [EMAIL PROTECTED] wrote: Let's get together on IRC (#php.doc) to discuss. Since Tony and I aren't working this week ;-) I'd suggest this date and time: - Tuesday, September 2, 11:00 CET (10:00 GMT/9:00 UTC) Err. Could we delay it for ~90minutes? I have a meeting from 10:30 CET, which I fear could take an hour.. and +30 just-in-case :) Sorry for the late heads up :( -Hannes
Re: [PHP-DOC] Patch for documentation
Hannes Magnusson schrieb: On Tue, Aug 26, 2008 at 16:48, Stefan Hinz [EMAIL PROTECTED] wrote: Let's get together on IRC (#php.doc) to discuss. Since Tony and I aren't working this week ;-) I'd suggest this date and time: - Tuesday, September 2, 11:00 CET (10:00 GMT/9:00 UTC) Err. Could we delay it for ~90minutes? I have a meeting from 10:30 CET, which I fear could take an hour.. and +30 just-in-case :) Okay, so 12:30 CET (11:30 GMT) it shall be. Sorry for the late heads up :( Np. Regards, Stefan -- *** Sun Microsystems GmbHStefan Hinz Sonnenallee 1Manager Documentation, Database Group 85551 Kirchheim-Heimstetten Phone: +49-30-82702940 Germany Fax: +49-30-82702941 http://www.sun.demailto: [EMAIL PROTECTED] Amtsgericht Muenchen: HRB161028 Geschaeftsfuehrer: Thomas Schroeder, Wolfgang Engels, Dr. Roland Boemer Vorsitzender des Aufsichtsrates: Martin Haering ***
Re: [PHP-DOC] Patch for documentation
Hannes Magnusson schrieb: On Tue, Aug 26, 2008 at 16:48, Stefan Hinz [EMAIL PROTECTED] wrote: Let's get together on IRC (#php.doc) to discuss. Since Tony and I aren't working this week ;-) I'd suggest this date and time: - Tuesday, September 2, 11:00 CET (10:00 GMT/9:00 UTC) Err. Could we delay it for ~90minutes? I have a meeting from 10:30 CET, which I fear could take an hour.. and +30 just-in-case :) Sorry for another mail. I'll be available tomorrow for the first 30 minutes only (need to pick up my son from school; it'll be his second school day). Let's discuss the general procedures first; I'll leave it to you guys to sort out the details afterwards. We can schedule a follow-up meeting if it turns out there's more that should be discussed. Regards, Stefan -- *** Sun Microsystems GmbHStefan Hinz Sonnenallee 1Manager Documentation, Database Group 85551 Kirchheim-Heimstetten Phone: +49-30-82702940 Germany Fax: +49-30-82702941 http://www.sun.demailto: [EMAIL PROTECTED] Amtsgericht Muenchen: HRB161028 Geschaeftsfuehrer: Thomas Schroeder, Wolfgang Engels, Dr. Roland Boemer Vorsitzender des Aufsichtsrates: Martin Haering ***
Re: [PHP-DOC] [HEADSUP] New phpweb branch
Hi Ross: On Sat, Aug 30, 2008 at 11:57:55AM +0100, Ross Masters wrote: On Sat, Aug 30, 2008 at 05:04 AM, Daniel Convissor wrote: The font size is nowhere hardcoded. It uses em and %. That's hard coding. We shouldn't be setting it at all. It's not hard coding here. Let me explain: Using em measurements we can set a font to be proportionally bigger or smaller than the font-size for it's container. For example: body { font-size: 0.75em; } /* Set all fonts to be 0.75 * the browser size */ body h1 { font-size: 1.25em; } /* Set h1 elements to be 1.25 * it's container */ body p { font-size: 1.00em; } /* Set p elements to be the same size as it's container (0.75) */ Exactly. Okay, let's stop arguing about semantics of the meaning of hard coding. The example you're giving me above is telling the browser to render the fonts to .75 of normal. I am firmly against any CSS telling the browser to render a page's main content in any size other than the browser's default. Allow me to elaborate on what I mean by main content to avoid further semantic discussions/misunderstandings. Setting navigational elements, side bars, footers, etc is totally cool. This can be done by directly specifying a font size for those particular elements. Setting the font size of the main text (the section on pb11's home page that starts with The PHP development team would like to announce the immediate availability of PHP 4.4.9...) is unnecessary and undesirable. So, in the case of pb11, I respectfully request that the HTML an CSS be tweaked to put each page block/section into their own div/span/whatever then setting the font size for each particular section. So, for example, the home page would contian the following elements: * search * nav header * left side bar * main content (don't set the font-size for this one) * right side bar * footer Oh, by the way, the CSS at http://pb11.php.net/styles/style_uncompressed.css is setting the the body to 62.5%, not 0.75em (at least as of 10:30 New York time). If the end user had a visual impairment they would set their browser's font sizes to a larger setting. Which I do. Because our font sizes are proportional to that setting their view of the page has larger text than someone who's browser font-size is set to normal. Yes, but the CSS is then setting it to 62.5% of my setting. So it's no longer at my setting. If we didn't set font-sizes at all all text would be the same size (assuming we're using a CSS Reset) which is pretty ugly :-) Perhaps I misunderstand what you mean by all text would be the same size. I downloaded the home page and CSS from pb11, took out all CSS except the resets, then refreshed. The various header (h1, h2, etc) element sizes behaved normally (with h2 being larger than normal and h1 being larger than that, etc). Thank you, --Dan -- T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y data intensive web and database programming http://www.AnalysisAndSolutions.com/ 4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409
[PHP-DOC] Configure failing with EntityRef: expecting ';' and chunk is not well balanced error
I'm trying to build the PHP docs locally but configure.php is failing with the following error: == Loading and parsing manual.xml... failed. ERROR (/Users/tedsr/phpdoc2/phpdoc/en/install/pecl.xml:147:21) url.pecl.submit. -^ EntityRef: expecting ';' ERROR (/Users/tedsr/phpdoc2/phpdoc/en/install/pecl.xml:unknown) chunk is not well balanced Previous errors too severe. Stopping here. Eyh man. No worries. Happ shittens. Try again after fixing the errors above. == I looked (briefly) at the source and found that there are multiple uses of $url throughout the source so fixing that one instance doesn't seem like a solution. Rather, it seems, I'm missing an entity declaration (or something like that). I seem to recall some emails on the list that might have been related, but I don't recall what the solution was (or if they were even related). Sorry This is based on the HEAD of phpdoc checked out a few minutes ago. Any ideas? Thanks in advance. Ted Stresen-Reuter http://tedmasterweb.com
Re: [PHP-DOC] [HEADSUP] New phpweb branch
Hi Dan, Sorry if I came across rudely there, that wasn't my intention. Daniel Convissor [EMAIL PROTECTED] wrote in message news:[EMAIL PROTECTED] Allow me to elaborate on what I mean by main content to avoid further semantic discussions/misunderstandings. Setting navigational elements, side bars, footers, etc is totally cool. This can be done by directly specifying a font size for those particular elements. Setting the font size of the main text (the section on pb11's home page that starts with The PHP development team would like to announce the immediate availability of PHP 4.4.9...) is unnecessary and undesirable. So, in the case of pb11, I respectfully request that the HTML an CSS be tweaked to put each page block/section into their own div/span/whatever then setting the font size for each particular section. So, for example, the home page would contian the following elements: * search * nav header * left side bar * main content (don't set the font-size for this one) * right side bar * footer Oh, by the way, the CSS at http://pb11.php.net/styles/style_uncompressed.css is setting the the body to 62.5%, not 0.75em (at least as of 10:30 New York time). As far as I see it the best practice is to not set a font-size for the body tag and to allow p to use whatever it wants. Then apply proportional (em) font-sizes to headings and such to make them scale with the browser sizes. Again, hope I didn't come across wrongly :-) Regards, Ross -- Ross Masters [EMAIL PROTECTED] http://www.uvshock.co.uk/
Re: [PHP-DOC] [HEADSUP] New phpweb branch
On Mon, Sep 1, 2008 at 16:38, Daniel Convissor [EMAIL PROTECTED] wrote: Hi Ross: On Sat, Aug 30, 2008 at 11:57:55AM +0100, Ross Masters wrote: On Sat, Aug 30, 2008 at 05:04 AM, Daniel Convissor wrote: The font size is nowhere hardcoded. It uses em and %. That's hard coding. We shouldn't be setting it at all. It's not hard coding here. Let me explain: Using em measurements we can set a font to be proportionally bigger or smaller than the font-size for it's container. For example: body { font-size: 0.75em; } /* Set all fonts to be 0.75 * the browser size */ body h1 { font-size: 1.25em; } /* Set h1 elements to be 1.25 * it's container */ body p { font-size: 1.00em; } /* Set p elements to be the same size as it's container (0.75) */ Exactly. Okay, let's stop arguing about semantics of the meaning of hard coding. I had a very hard time understanding what you meant with hard coding as it definitely wasn't *hardcoded*. Using % and ems is the way to go exactly for this reason; give the user the choice of resizing. The example you're giving me above is telling the browser to render the fonts to .75 of normal. I am firmly against any CSS telling the browser to render a page's main content in any size other than the browser's default. Thats interesting. Firebug tells me the font size is 100%.. If we didn't set font-sizes at all all text would be the same size (assuming we're using a CSS Reset) which is pretty ugly :-) Perhaps I misunderstand what you mean by all text would be the same size. I downloaded the home page and CSS from pb11, took out all CSS except the resets, then refreshed. The various header (h1, h2, etc) element sizes behaved normally (with h2 being larger than normal and h1 being larger than that, etc). The footer text size should not be the same size as the main content. The main content size should not be the same size as menu items. ... -Hannes
Re: [PHP-DOC] Configure failing with EntityRef: expecting ';' and chunk is not well balanced error
On Mon, Sep 1, 2008 at 17:03, G. T. Stresen-Reuter [EMAIL PROTECTED] wrote: I'm trying to build the PHP docs locally but configure.php is failing with the following error: == Loading and parsing manual.xml... failed. ERROR (/Users/tedsr/phpdoc2/phpdoc/en/install/pecl.xml:147:21) url.pecl.submit. -^ EntityRef: expecting ';' ERROR (/Users/tedsr/phpdoc2/phpdoc/en/install/pecl.xml:unknown) chunk is not well balanced Previous errors too severe. Stopping here. Eyh man. No worries. Happ shittens. Try again after fixing the errors above. == I looked (briefly) at the source and found that there are multiple uses of $url throughout the source so fixing that one instance doesn't seem like a solution. Rather, it seems, I'm missing an entity declaration (or something like that). No no. Just like the error message said expecting ';'.. should be url.pecl.submit; :) Thanks for the heads up -Hannes
Re: [PHP-DOC] [HEADSUP] New phpweb branch
Hi Ross: Sorry if I came across rudely there, that wasn't my intention. No, didn't take it that way at all. Similarly, sorry if I came across harshly. As far as I see it the best practice is to not set a font-size for the body tag and to allow p to use whatever it wants. Then apply proportional (em) font-sizes to headings and such to make them scale with the browser sizes. Then we are in agreement. :) Can the existing HTML/CSS please be adjusted to do that? Sorry to be passing the buck on this rather than providing a patch. I need to finish plastering my bedroom before my wife kills me. Thanks, --Dan -- T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y data intensive web and database programming http://www.AnalysisAndSolutions.com/ 4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409
Re: [PHP-DOC] [HEADSUP] New phpweb branch
Hi Hannes: I had a very hard time understanding what you meant with hard coding as it definitely wasn't *hardcoded*. Using % and ems is the way to go exactly for this reason; give the user the choice of resizing. Yup. Email conversations are rife with misunderstandings. :) If we didn't set font-sizes at all all text would be the same size (assuming we're using a CSS Reset) which is pretty ugly :-) Perhaps I misunderstand what you mean by all text would be the same size. I downloaded the home page and CSS from pb11, took out all CSS except the resets, then refreshed. The various header (h1, h2, etc) element sizes behaved normally (with h2 being larger than normal and h1 being larger than that, etc). The footer text size should not be the same size as the main content. The main content size should not be the same size as menu items. Agreed. Another misunderstanding. Ross and I were discussing the resets done at the top of the CSS file and how that impacts the rest of the document. Thanks, --Dan -- T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y data intensive web and database programming http://www.AnalysisAndSolutions.com/ 4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409
Re: [PHP-DOC] [HEADSUP] New phpweb branch
On Mon, Sep 1, 2008 at 22:09, Daniel Convissor [EMAIL PROTECTED] wrote: The footer text size should not be the same size as the main content. The main content size should not be the same size as menu items. Agreed. Another misunderstanding. Ross and I were discussing the resets done at the top of the CSS file and how that impacts the rest of the document. How does http://pb11.php.net/design/styles.html look to you? -Hannes
Re: [PHP-DOC] [HEADSUP] New phpweb branch
Hannes Magnusson [EMAIL PROTECTED] wrote in message news:[EMAIL PROTECTED] How does http://pb11.php.net/design/styles.html look to you? -Hannes I have a few suggestions: * Apply cursor: help; to acronym and abbr * You could change the highlighting for a blockquote - give it a lighter background for example -just a preference. It's looking great at the moment though! -- Ross Masters [EMAIL PROTECTED] http://www.uvshock.co.uk/
Re: [PHP-DOC] [HEADSUP] New phpweb branch
Hi Hannes: How does http://pb11.php.net/design/styles.html look to you? http://www.analysisandsolutions.com/php/web.feedback.styles.1.png I'm using Firefox 3.0.1. Oh, one thing that may have been throwing you off before about the size of the headers is I had the minimum font size set. I turned it off for the screen shot above. Sorry for any confusion about that. Anyway, the main text is still very small, and now even smaller. :) It's also tiny in IE 7. Thanks, --Dan -- T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y data intensive web and database programming http://www.AnalysisAndSolutions.com/ 4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409