Sorry, I meant to say, "Since I DO NOT have extensive knowledge of the project..., I need assistance."
Note that I have received some assistance from 2 community members who are external to Sun, which has been helpful. However, piecing together information from various sources through email for a project that has this amount of impact to documentation, is not ideal. Is there a contact at Sun, who is working through the usual channels that can provide some assistance with required updates? Thanks much! Nita On 08/27/09 13:25, Juanita Heieck wrote: > Hi Roland, > > Please forward me any PSARC material info, including answers to > questions regarding documentation impact: man pages and > system administration documentation impact. > > This project has greater impact that I originally thought, and since I > have extensive background or personal knowledge of > all the intricacies of this project and have not heard back from you > regarding how to proceed with updates to the documentation, > I need to start looking at the PSARC materials to determine where > to begin with documentation changes for this feature and who > else at Sun I might contact for assistance. > > Thanks for your cooperation in advance. > > Nita > > On 08/21/09 21:37, Roland Mainz wrote: >> Hi! >> >> ---- >> >> 2009-08-22: ksh93-integration update 2 tarballs for Solaris 11 >> Nevada+OpenSolaris/Indiana >> >> These tarballs ([2]) are intended to be installed over an existing >> Solaris Nevada/Indiana/OpenSolaris >= B110 i386 or SPARC installation >> and provide ksh93t+_20090505 and the content described in PSARC/2009/248 >> ("ksh93 update to 2009-03-10") and PSARC/2009/249 ("more ksh93 command >> conversions"). >> Note that the binaries are provided for testing and evaluation purposes >> ONLY. >> >> Please report any problems/errors/bugs/comments to the ksh93-integration >> project bugzilla[5] or the ksh93-integration mailinglist[4] (please >> subscribe before posting). >> >> >> **** Quick links: >> - Download&&install instructions: >> http://www.opensolaris.org/os/project/ksh93-integration/downloads/2009-08-22/ >> - Webrev: >> http://cr.opensolaris.org/~gisburn/ksh93_integration_update2_20090822_webrev/ >> >> <http://cr.opensolaris.org/%7Egisburn/ksh93_integration_update2_20090822_webrev/> >> >> >> **** Differences to the previous test release (2009-07-02) >> The only difference to the previous test release >> (http://www.opensolaris.org/os/project/ksh93-integration/downloads/2009-07-02/) >> is the fix for the /usr/bin/tail, /usr/xpg4/bin/tail and "tail" >> utilities to handle FIFOs correctly (see >> http://bugs.grommit.com/show_bug.cgi?id=630 ('AST "tail" fails to handle >> FIFOs correctly' ; the patch (including a testcase) can be found at >> http://bugs.grommit.com/attachment.cgi?id=331)). >> >> The fixed "tail" utility can be identified based on it's version number >> which should now print "2009-08-15": >> -- snip -- >> $ tail >> --version >> >> version tail (AT&T Research) 2009-08-15 >> -- snip -- >> >> >> **** Highlights of this release: >> >> - Many bugfixes to ksh93, it's infrastructure and other >> commands, primarily focussing on stability, improved error >> checking, performance and fixing support for large, complex >> variable trees. >> >> - The several commands have been updated (or added) and now >> include common GNU+BSD+AST features, including: >> /usr/bin/cksum >> /usr/bin/cmp >> /usr/bin/comm >> /usr/bin/cut >> /usr/bin/head >> /usr/bin/join >> /usr/bin/kill >> /usr/bin/logname >> /usr/bin/mkfifo >> /usr/bin/paste >> /usr/bin/print >> /usr/bin/rev >> /usr/bin/sleep >> /usr/bin/sum >> /usr/bin/tail >> /usr/bin/tee >> /usr/bin/test >> /usr/bin/uniq >> /usr/bin/wait >> /usr/bin/wc >> /usr/xpg4/bin/tail >> (the full list of updated commands can be found below) >> >> - The following bugs/RFEs will be fixed by this putback: >> +--------------------------------------------------------------+ >> |BugID |Title | >> |-------+------------------------------------------------------| >> |4701104|*tail* tail -r has limitations on un-mmappable files | >> | |(/etc/mnttab) | >> |-------+------------------------------------------------------| >> |6605478|ksh93 profile shell option does not work | >> |-------+------------------------------------------------------| >> |6705126|first call to read does not honor new setting of | >> | |HISTFILE | >> |-------+------------------------------------------------------| >> |6764665|*libpp* Array overrun in libpp | >> |-------+------------------------------------------------------| >> |6765756|*libast* Array overruns in libast | >> |-------+------------------------------------------------------| >> |6769332|Recursive function+command substitutions terminate | >> | |shell after 257 iterations | >> |-------+------------------------------------------------------| >> |6778077|*ksh93* does not understand "THAW" as a signal for use| >> | |with trap | >> |-------+------------------------------------------------------| >> |6789247|[ku1] libast/ksh93 1-digit hexfloat base | >> | |conversion rounds incorrectly | >> |-------+------------------------------------------------------| >> |6790507|RFE: Update /usr/bin/tail and /usr/xpg4/bin/tail to | >> | |AT&T AST "tail" | >> |-------+------------------------------------------------------| >> |6791838|*ksh93* unset of a variable which is not set | >> | |should return 0 | >> |-------+------------------------------------------------------| >> |6793714|RFE: Update /usr/bin/comm to AT&T AST "comm" | >> |-------+------------------------------------------------------| >> |6793719|RFE: Update /usr/bin/cut to AT&T AST "cut" | >> |-------+------------------------------------------------------| >> |6793721|RFE: Update /usr/bin/paste to AT&T AST "paste" | >> |-------+------------------------------------------------------| >> |6793722|RFE: Update /usr/bin/cmp to AT&T AST "cmp" | >> |-------+------------------------------------------------------| >> |6793726|RFE: Update /usr/bin/uniq to AT&T AST "uniq" | >> |-------+------------------------------------------------------| >> |6793735|RFE: Update /usr/bin/wc to AT&T AST "wc" | >> |-------+------------------------------------------------------| >> |6793744|RFE: Add /usr/share/doc/ksh/ for ksh93 documentation | >> |-------+------------------------------------------------------| >> |6793747|RFE: Provide "print" builtin as /usr/bin/ | >> | |print for external applications | >> |-------+------------------------------------------------------| >> |6793763|RFE: Update /usr/bin/ksh93 to ast-ksh.2009-05-05 | >> |-------+------------------------------------------------------| >> |6794952|RFE: Enable "globstar" option in /etc/ksh.kshrc | >> |-------+------------------------------------------------------| >> |6805792|[ Moving local compound var into array does not work | >> |-------+------------------------------------------------------| >> |6805794| printf returns "invalid character constant" for | >> | |$ printf "%dn" "`;<euro>" | >> |-------+------------------------------------------------------| >> |6805795|[ku1] ksh93 does not differ between -0 and +0 | >> |-------+------------------------------------------------------| >> |6805797|[ku1]Can't append to nodes of an array of compound | >> | | vars if addressing them via nameref | >> |-------+------------------------------------------------------| >> |6805799|Indexed compound variable arrays do not work... | >> |-------+------------------------------------------------------| >> |6805800|[Declaring associative compound array does not work | >> |-------+------------------------------------------------------| >> |6805812|RFE: Update /usr/bin/head to AT&T AST "head" | >> |-------+------------------------------------------------------| >> |6805813|RFE: Update /usr/bin/join to AT&T AST "join" | >> |-------+------------------------------------------------------| >> |6805814|RFE: Update /usr/bin/mkfifo to AT&T AST "mkfifo" | >> |-------+------------------------------------------------------| >> |6805819|RFE: Update /usr/bin/tee to AT&T AST "tee" | >> |-------+------------------------------------------------------| >> |6809663|shlint missing ending newline on errors | >> |-------+------------------------------------------------------| >> |6811916|ksh93 repeatedly seg faults when "tee" builtin is | >> | |interupted via <ctrl-c> in inteactive mode | >> |-------+------------------------------------------------------| >> |6821113|SUNWosdem package issues | >> |-------+------------------------------------------------------| >> |6828644|RFE: Update /usr/bin/logname to AT&T AST "logname" | >> |-------+------------------------------------------------------| >> |6828692|RFE: Update /usr/bin/cksum to AT&T AST "cksum" | >> |-------+------------------------------------------------------| >> |6834184|ksh93 gets SIGSEGV if HISTFILE is changed in place. | >> |-------+------------------------------------------------------| >> |6834207|ksh93 gets SIGSEGV on interactive function definition | >> | |with HISTSIZE unset | >> |-------+------------------------------------------------------| >> |6835835|ksh93 "cat" builtin does not handle "-n" correctly | >> |-------+------------------------------------------------------| >> |6841442|Need exception list for OS/Net trees managed via | >> | |Subversion | >> |-------+------------------------------------------------------| >> |6848486|"echo ${test}" with test undefined crashes the shell | >> |-------+------------------------------------------------------| >> |6850672|ksh93 (VISUAL=vi) crashes with memory fault | >> | |while scolling through history | >> |-------+------------------------------------------------------| >> |6855875|typeset -X x ; print $x # does not print sufficient | >> | |digits to restore value | >> +--------------------------------------------------------------+ >> >> >> >> **** Install instructions: >> >> >> *** Basic installation: >> >> 1. Download the tarball: >> + i386/AMD64: >> http://www.opensolaris.org/os/project/ksh93-integration/downloads/ksh93_integration_20090822_snapshot_i386.tar.bz2 >> + SPARC: >> http://www.opensolaris.org/os/project/ksh93-integration/downloads/ksh93_integration_20090822_snapshot_sparc.tar.bz2 >> 2. Verify the MD5 checksum: >> + i386/AMD64: MD5 >> (ksh93_integration_20090822_snapshot_i386.tar.bz2)= >> a0be4104332c4b4e7b2276e2c5ec5022 >> + SPARC: MD5 >> (ksh93_integration_20090822_snapshot_sparc.tar.bz2)= >> 7e51d76427f2a033f721fef6a87531af >> 3. Login as user "root": >> 4. Change directory to / and unpack the tarball with /usr/bin/tar >> using the "xvof" option ("o" is very important to set the file >> ownership to "root") >> >> >> ** Example for i386/AMD64: >> >> $ cd /tmp >> $ /usr/sfw/bin/wget \ >> http://www.opensolaris.org/os/project/ksh93-integration/downloads/ksh93_integration_20090822_snapshot_i386.tar.bz2 >> $ sum -x md5 ksh93_integration_20090822_snapshot_i386.tar.bz2 >> a0be4104332c4b4e7b2276e2c5ec5022 >> ksh93_integration_20090822_snapshot_i386.tar.bz2 >> # cd / >> # sync ; sync >> # bzcat </tmp/ksh93_integration_20090822_snapshot_i386.tar.bz2 | tar >> -xvof - >> # sync ; sync >> >> >> ** Example for SPARC: >> >> $ cd /tmp >> $ /usr/sfw/bin/wget \ >> http://www.opensolaris.org/os/project/ksh93-integration/downloads/ksh93_integration_20090822_snapshot_sparc.tar.bz2 >> $ sum -x md5 ksh93_integration_20090822_snapshot_sparc.tar.bz2 >> 7e51d76427f2a033f721fef6a87531af >> ksh93_integration_20090822_snapshot_sparc.tar.bz2 >> # cd / >> # sync ; sync >> # bzcat </tmp/ksh93_integration_20090822_snapshot_sparc.tar.bz2 | tar >> -xvof - >> # sync ; sync >> >> >> *** [OPTIONAL] Using ksh93 as /sbin/sh: >> >> After installation of the tarball the following steps will replace >> the original Bourne shell with ksh93: >> Example for i386/AMD64: >> >> # cp /usr/bin/i86/ksh93 /sbin/ksh93 >> # [[ ! -f /sbin/bsh ]] && mv /sbin/sh /sbin/bsh || rm /sbin/sh >> # mv /sbin/ksh93 /sbin/sh >> # sync ; sync >> >> >> ** Example for SPARC: >> >> # cp /usr/bin/sparcv7/ksh93 /sbin/ksh93 >> # [[ ! -f /sbin/bsh ]] && mv /sbin/sh /sbin/bsh || rm /sbin/sh >> # mv /sbin/ksh93 /sbin/sh >> # sync ; sync >> >> >> >> **** Notes: >> >> >> * This tarball matches ksh93t+ (=ast-ksh.2009-06-22) with many >> many changes since the last version. Please test the binaries >> extensively. >> * The following commands have been updated (or added) and now >> include common GNU+BSD+AST features: >> /usr/bin/bg, /usr/bin/cd, /usr/bin/cksum, /usr/bin/cmp, >> /usr/bin/comm, /usr/bin/command, /usr/bin/cut, /usr/bin/fc, >> /usr/bin/fg, /usr/bin/getopts, /usr/bin/hash, /usr/bin/head, >> /usr/bin/jobs, /usr/bin/join, /usr/bin/kill, /usr/bin/logname, >> /usr/bin/mkfifo, /usr/bin/paste, /usr/bin/print, /usr/bin/read, >> /usr/bin/rev, /usr/bin/sleep, /usr/bin/sum, /usr/bin/tail, >> /usr/bin/tee, /usr/bin/test, /usr/bin/type, /usr/bin/ulimit, >> /usr/bin/umask, /usr/bin/unalias, /usr/bin/uniq, /usr/bin/wait, >> /usr/bin/wc, /usr/xpg4/bin/tail >> * The binaries now are build from a B111-based tree and require >> SXCR B110 or higher >> * Sources/diffs/webrevs: >> + The diffs between Solaris Nevada B111 and the current >> ksh93-integration tree can be obtained via... >> o ... Subversion: >> $ (mkdir svnexport_new ; cd svnexport_new ; svn export -r 1674 >> svn://svn.genunix.org/on/branches/ksh93/gisburn/prototype021/usr/src) >> $ (mkdir svnexport_old ; cd svnexport_old ; svn export >> svn://svn.genunix.org/on/tags/b111/usr/src) >> $ gdiff -r -u -N svnexport_old/src svnexport_new/src | \ >> sed 's/svnexport_new\///g;s/svnexport_old\///g' \ >> >>> svn_genunix_org_on_branches_ksh93_gisburn_prototype021_rev_b111_1674.diff.txt >>> >> o ... unified diff >> (http://www.opensolaris.org/os/project/ksh93-integration/downloads/svn_genunix_org_on_branches_ksh93_gisburn_prototype021_rev_b111_1674.diff.txt >> , 2.25MB, MD5 checksum is 54fd9eba704d537531d979a0010f287d). >> o ... Mercurial/HG export bundle >> (http://www.opensolaris.org/os/project/ksh93-integration/downloads/ksh93_integration_update2_20090822_hg_export_001.hgexport.bz2 >> , 212KB, MD5 checksum is 2b0577a78aa91a3cdc15705b6c6fd94e) >> + Alternatively webrev pages are available at >> http://cr.opensolaris.org/~gisburn/ksh93_integration_update2_20090822_webrev/ >> >> <http://cr.opensolaris.org/%7Egisburn/ksh93_integration_update2_20090822_webrev/> >> * "multiline" input mode is now enabled by default in >> /etc/ksh.kshrc to match input/editor behaviour of bash. >> * /etc/ksh.kshrc now sets a default prompt (PS1) which contains >> <username>@<hostname>:<current_directory>$<blank> for normal >> users and <username>@<hostname>:<current_directory>#<blank> for >> user "root"; the prompt length itself is limited to ~~30 >> characters to ensure it only occupies ~~1/4 of a standard 80x24 >> terminal window. >> * <esc><ctrl-l> was added to emacs/gmacs mode to clear the screen >> (per community requests and to be in sync with bash) >> * 64bit binaries and libraries are now included (and used by >> default if the hardware is 64bit capable) >> * "shcomp", the shell script compiler is now included as /usr/bin >> /shcomp. >> * AST l10n utilities are stored in /usr/ast/bin/. >> * Starting with ksh93s+ multibyte characters can be used for >> variable/function/etc.-names. Please test this functionality >> extensively. >> * The tarball was created using the >> build_ksh93_standalone_tarball.sh script which is available in >> the base directory of the prototype021 tree. >> Note: The script can only be used after a successfull >> $ cd usr/ src ; (cd tools ; make install) ; make setup ; \ >> dmake install #-sequence, otherwise the resulting tarball >> will be incomplete. >> * The tarballs do not provide a manual page for ksh93. Please use >> the manual page for ksh93s+ in the meantime. >> * The ksh93 binaries can be build from source like this: >> (Instructions are for Solaris i386/AMD64; SPARC requires minor >> adjustments) >> 1. Pull sources and extract closed bin stuff (files can be >> obtained from opensolaris.org): >> $ mkdir test_x86 ; cd test_x86 >> $ svn checkout -r 1674 \ >> svn://svn.genunix.org/on/branches/ksh93/gisburn/prototype021/usr >> $ bzcat <../download/on-closed-bins-nd.i386.tar.bz2 | \ >> tar -xf - >> $ bzcat <../download/on-closed-bins.i386.tar.bz2 | \ >> tar -xf >> - >> $ cd .. >> 2. Create opensolaris.sh. >> This is the usual opensolaris.sh with the paths adjusted to >> match your location of the sources. >> Example for the changes applies to opensolaris.sh (for my >> workspace): >> >> --- ./test1_x86/usr/src/tools/env/opensolaris.sh <date> >> +++ ./opensolaris.sh <date> >> @@ -43,10 +43,10 @@ >> >> # This is a variable for the rest of the script - GATE doesn't >> # matter to nightly itself >> -GATE=testws; export GATE >> +GATE=prototype021; export GATE >> >> +# workaround for B111 build issue >> +export NOT_UNDER_SCM=true >> >> # CODEMGR_WS - where is your workspace at (or what should >> # nightly name it) >> -CODEMGR_WS="/export/$GATE"; export CODEMGR_WS >> +CODEMGR_WS="/home/test001/ksh93/on_build1/$GATE"; export CODEMGR_WS >> >> # Location of encumbered binaries. >> ON_CLOSED_BINS="$CODEMGR_WS/closed"; export ON_CLOSED_BINS >> >> 3. Run "bldenv": >> $ env - SHELL=$SHELL TERM=$TERM HOME=$HOME LOGNAME=$LOGNAME \ >> DISPLAY=$DISPLAY XAUTHORITY=$XAUTHORITY LANG=C LC_ALL=C \ >> PAGER=less MANPATH=$MANPATH /opt/onbld/bin/bldenv \ >> opensolaris.sh # >> 4. Build it (the quick way): >> $ cd prototype021/usr/src >> $ export CW_NO_SHADOW=1 >> $ time nice make setup 2>&1 | tee -a buildlog_setup.log >> $ time nice dmake install >buildlog.log 2>&1 >> >> >> >> >> Finally: Please check >> http://www.opensolaris.org/os/project/ksh93-integration/downloads/2009-08-22/ >> for any updates or additional comments... >> >> >> >> **** Links/References: >> [1]=ksh93-integration/migration project home page: >> http://www.opensolaris.org/os/project/ksh93-integration/ >> >> [2]=2009-08-22 ksh93-integration update2 test binaries: >> http://www.opensolaris.org/os/project/ksh93-integration/downloads/2009-08-22/ >> >> [3]=ksh93s+ manual page: >> http://www.opensolaris.org/os/project/ksh93-integration/docs/ksh93s/man/man1/sh/ >> >> [4]=ksh93-integration mailinglist: >> http://mail.opensolaris.org/mailman/listinfo/ksh93-integration-discuss/ >> ; please subscribe before posting (and please avoid flamewars) !! >> >> [5]=ksh93-integration project bugzilla: >> http://bugs.grommit.com/enter_bug.cgi?product=ksh93-integration >> >> >> ---- >> >> Bye, >> Roland >> >> P.S.: Reply-To: is set to ksh93-integration-discuss at opensolaris.org >> <mailto:ksh93-integration-discuss at opensolaris.org> >> >> > > ------------------------------------------------------------------------ > > _______________________________________________ > ksh93-integration-discuss mailing list > ksh93-integration-discuss at opensolaris.org > http://mail.opensolaris.org/mailman/listinfo/ksh93-integration-discuss > -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://mail.opensolaris.org/pipermail/ksh93-integration-discuss/attachments/20090827/6cb1bdbb/attachment.html>