#7632: add to Developer's Guide information how to write portable code
----------------------------+------------------------
Reporter: drkirkby | Owner: drkirkby
Type: defect | Status: new
Priority: major | Milestone: sage-6.4
Component: porting | Resolution:
Keywords: | Merged in:
Authors: | Reviewers:
Report Upstream: N/A | Work issues:
Branch: | Commit:
Dependencies: | Stopgaps:
----------------------------+------------------------
Description changed by chapoton:
Old description:
> As discussed on [http://groups.google.com/group/sage-
> devel/browse_thread/thread/bc1ea5faa96eea13 sage-devel], we need to
> document how to write portable POSIX conforming code, using best-
> practices. One such example, which started the discussion, was using
>
> {{{
> test "$1" && test "$2"
> }}}
>
> and NOT
>
> {{{
> test "$1" -a "$2"
> }}}
>
> It would be wise to cite the URL for the 2004 POSIX standard (IEEE Std
> 1003.1, 2004 Edition), in the developers guide. The URL is:
>
> http://www.opengroup.org/onlinepubs/009695399/
>
> (There is a later 2008 POSIX standard, but some of changes in this may
> not be implemented in everyone's operating system, whereas most operating
> systems will implement the 2004 standard).
>
> Unfortunately, due to what I believe is probably the use of frames, all
> URLs on this site appear to be the same. As such, if directing people to
> a URL, right-click on the item required, and copy the URL. E.g for the
> 'test' tool, it is:
>
> http://www.opengroup.org/onlinepubs/009695399/utilities/test.html
>
> For 'cp' it is
>
> http://www.opengroup.org/onlinepubs/009695399/utilities/cp.html
New description:
As discussed on [http://groups.google.com/group/sage-
devel/browse_thread/thread/bc1ea5faa96eea13 sage-devel], we need to
document how to write portable POSIX conforming code, using best-
practices. One such example, which started the discussion, was using
{{{
test "$1" && test "$2"
}}}
and NOT
{{{
test "$1" -a "$2"
}}}
It would be wise to cite the URL for the 2004 POSIX standard (IEEE Std
1003.1, 2004 Edition), in the developers guide. The URL is:
http://www.opengroup.org/onlinepubs/009695399/
(There is a later 2008 POSIX standard, but some of changes in this may not
be implemented in everyone's operating system, whereas most operating
systems will implement the 2004 standard).
Unfortunately, due to what I believe is probably the use of frames, all
URLs on this site appear to be the same. As such, if directing people to a
URL, right-click on the item required, and copy the URL. E.g for the
'test' tool, it is:
http://www.opengroup.org/onlinepubs/009695399/utilities/test.html
For 'cp' it is
http://www.opengroup.org/onlinepubs/009695399/utilities/cp.html
--
--
Ticket URL: <http://trac.sagemath.org/ticket/7632#comment:7>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.
