John H Palmieri wrote:
> On Dec 8, 3:12 pm, Minh Nguyen <[email protected]> wrote:
>> Hi David,
>>
>> On Wed, Dec 9, 2009 at 10:08 AM, Dr. David Kirkby
>>
>> <[email protected]> wrote:
>>
>> <SNIP>
>>
>>> Yes, I'll do that. I wont promise when, as I am a bit busy now. Many of 
>>> these
>>> things can be found in documents on the web, but it would no doubt help to 
>>> have
>>> them in the developer guide, particularly those related to Sage.
>> Could you please open a ticket for this issue? 

Done.

http://trac.sagemath.org/sage_trac/ticket/7632


> I'll see if I can write
>> a short paragraph or two on the "and" and "or" operators. It's better
>> to have something about these in the Developers' Guide than nothing at
>> all. Later one, if you think necessary you could elaborate on more
>> GNUism to avoid.
> 
> It also might be helpful to add to the developer's guide some links
> for sites where we can find posix standards like this (or for the
> arguments to "cp", for example), mentioning portability as
> motivation.  

I've put the links in the ticket above. There are two POSIX specs available on 
the web - the 2004 and the 2008 editions. It is safer to use only things in the 
2004 edition, as some older operating systems will not have the latest changes.

The URL for the 2004 edition (IEEE Std 1003.1, 2004 Edition) is:

http://www.opengroup.org/onlinepubs/009695399/

You need a bit of care if you want to cite pages, as all URLs appear to be 
identical - the site uses frames I believe. As such, its better to right-click 
on the page you want to show people, and grab the URL. A couple which have been 
the subject of portability issues in Sage are:

cp
http://www.opengroup.org/onlinepubs/009695399/utilities/cp.html

date
http://www.opengroup.org/onlinepubs/009695399/utilities/date.html

test (the subject of this email)
http://www.opengroup.org/onlinepubs/009695399/utilities/test.html

I'm not aware of any issues in Sage because '-a' has been used rather than '&&' 
in tests. But it seems pointless not to use the recommended way, and instead 
use 
a deprecated method.

> I forget: do we have links to the on-line python
> documentation in the developer's guide?  If not, we should.  Any other
> useful links we should include?

A link to the ISO standard for C and C++ would be nice, but I do not know of a 
location where you can get this information without spending close to $500. 
Does 
anyone know of a freely available standard for C and C++ ? Fortran would be 
useful too, though probably a lot less useful than C and C++.

A link to the newsgroup comp.unix.shell

http://groups.google.com/group/comp.unix.shell/topics

would be useful, as that is one place to ask questions about shell scripts. (I 
prefer to use a news reader, rather than google groups, as I do not see much 
spam).

The Sun Studio compiler documentation is listed at
http://developers.sun.com/sunstudio/documentation/ss12u1/

The IBM's AIX compiler is at
http://docs.hp.com/en/7730/newhelp0610/index.htm

HP's HP-UX compiler is at
http://www-01.ibm.com/support/docview.wss?uid=swg27012860&aid=1

(Both Minh Nguyen  and I have made some efforts at building Sage on HP-UX and 
AIX. IBM's p-Series computers have CPUs running at 5 GHz - they would run Sage 
rather quickly!)

With the exception of some very common compiler options like -c, -o and -g, 
compilers from Sun, GNU, HP and IBM all have different options to mean the same 
thing. (Sun and GNU share -m64, but other compilers use other flags to create 
64-bit binaries).

Anyway, enough from me. If Ming starts that page, I'll add to it over time.


-- 
To post to this group, send an email to [email protected]
To unsubscribe from this group, send an email to 
[email protected]
For more options, visit this group at http://groups.google.com/group/sage-devel
URL: http://www.sagemath.org

Reply via email to