Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 110612 - [doc] remove the deprecated technotes
Summary: [doc] remove the deprecated technotes
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Unspecified (show other bugs)
Hardware: AMD64 Linux
: High normal (vote)
Assignee: AMD64 Project
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-10-27 05:27 UTC by Charles Duffy
Modified: 2006-04-29 11:34 UTC (History)
6 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
General doc patch (docs.patch,5.85 KB, patch)
2005-10-27 11:37 UTC, Simon Stelling (RETIRED)
Details | Diff
/proj/en/base/amd64/technotes/index.xml (index.xml,733 bytes, text/plain)
2005-10-31 05:36 UTC, Xavier Neys (RETIRED)
Details
removes technotes (patch,860 bytes, patch)
2006-01-16 12:30 UTC, Simon Stelling (RETIRED)
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Charles Duffy 2005-10-27 05:27:17 UTC
Based on the documentation at
http://www.gentoo.org/proj/en/base/amd64/technotes/install-32bit.xml, I expect
emul-linux-x86-baselibs (or, barring that, emul-linux-x86-compat or
emul-linux-x86-glibc) to create a symlink from /lib/ld-linux.so.2 to
/emul/linux/x86/lib/ld-linux.so.2.

Not only does this symlink not get created, but "find /emul/linux/x86 -type f
-name ld\*" comes up completely empty, so no 32-bit ld-linux appears to be
installed at all.

Reproducible: Always
Steps to Reproduce:
1.Install emul-linux-x86-{baselibs,compat,glibc}
2.Try to invoke a 32-bit app, or run "ldd" on said app.
Actual Results:  
App fails on account of the lack of a 32-bit loader

Expected Results:  
Ran (if invoked), or showed the libraries it was linked to (if not).

Portage 2.0.51.22-r2 (default-linux/amd64/2005.1, gcc-3.4.3, glibc-2.3.5-r0,
2.6.12.6-xenU x86_64)
=================================================================
System uname: 2.6.12.6-xenU x86_64 AMD Opteron(tm) Processor 848
Gentoo Base System version 1.6.12
dev-lang/python:     2.3.5
sys-apps/sandbox:    1.2.11
sys-devel/autoconf:  2.13, 2.59-r6
sys-devel/automake:  1.4_p6, 1.5, 1.6.3, 1.7.9-r1, 1.8.5-r3, 1.9.6-r1
sys-devel/binutils:  2.15.92.0.2-r10
sys-devel/libtool:   1.5.18-r1
virtual/os-headers:  2.6.11-r2
ACCEPT_KEYWORDS="amd64"
AUTOCLEAN="yes"
CBUILD="x86_64-pc-linux-gnu"
CFLAGS="-O2"
CHOST="x86_64-pc-linux-gnu"
CONFIG_PROTECT="/etc /usr/kde/2/share/config /usr/kde/3/share/config
/usr/share/config /var/qmail/control"
CONFIG_PROTECT_MASK="/etc/gconf /etc/terminfo /etc/env.d"
CXXFLAGS="-O2"
DISTDIR="/usr/portage/distfiles"
FEATURES="autoconfig distlocks sandbox sfperms strict"
GENTOO_MIRRORS="http://distfiles.gentoo.org
http://distro.ibiblio.org/pub/Linux/distributions/gentoo"
PKGDIR="/usr/portage/packages"
PORTAGE_TMPDIR="/var/tmp"
PORTDIR="/usr/portage"
PORTDIR_OVERLAY="/usr/local/portage"
SYNC="rsync://rsync.gentoo.org/gentoo-portage"
USE="amd64 acl alsa apache2 avi berkdb bitmap-fonts crypt cups eds emboss encode
foomaticdb fortran gif gnome gpm gstreamer gtk2 imlib ipv6 jpeg kde lzw lzw-tiff
mp3 mpeg mysql ncurses nls opengl pam pcre pdflib perl png python qt quicktime
readline sdl spell ssl tcpd tiff truetype-fonts type1-fonts udev usb userlocales
xpm xv zlib userland_GNU kernel_linux elibc_glibc"
Unset:  ASFLAGS, CTARGET, LANG, LC_ALL, LDFLAGS, LINGUAS, MAKEOPTS

# equery emul-linux-x86-*
[I--] [  ] app-emulation/emul-linux-x86-baselibs-2.3 (0)
[I--] [  ] app-emulation/emul-linux-x86-glibc-1000 (0)
[I--] [  ] app-emulation/emul-linux-x86-compat-1.0 (0)
# for PKG in emul-linux-x86-{baselibs,compat,glibc}; do equery f $PKG | grep
'/ld'; done
#
Comment 1 Charles Duffy 2005-10-27 07:17:43 UTC
I find that I *do* have a /lib32/ld-linux.so.2, though not a
/emul/linux/x86/lib/ld-linux.so.2. Attempting to exec 32-bit apps outside of
their chroot still returns ENOENT.
Comment 2 Simon Stelling (RETIRED) gentoo-dev 2005-10-27 08:37:02 UTC
this is already provided by glibc (not the emul-package, the native one)

$ equery b /lib32/ld-linux.so.2
[ Searching for file(s) /lib32/ld-linux.so.2 in *... ]
sys-libs/glibc-2.3.5-r2 (/lib32/ld-linux.so.2 -> ld-2.3.5.so)

 $ file /lib/ld-linux.so.2
/lib/ld-linux.so.2: symbolic link to `../lib32/ld-linux.so.2'
Comment 3 Charles Duffy 2005-10-27 08:45:21 UTC
Then this is a documentation bug, as the linked docs clearly state that a
symlink from /lib/ld-linux.so.2 will be created on installing the given packages.
Comment 4 Simon Stelling (RETIRED) gentoo-dev 2005-10-27 10:35:11 UTC
sorry, you are right. the technotes are deprecated, and we're replacing it with
newer, up to date documentation bit by bit. for the 32bit part, there is the
chroot howto:
http://www.gentoo.org/proj/en/base/amd64/howtos/index.xml?part=1&chap=3

it's only about chroots, but the whole emul-linux-x86-* stuff is handled by
portage anyway, so you don't have to care about it ;)
Comment 5 Simon Stelling (RETIRED) gentoo-dev 2005-10-27 11:37:00 UTC
Created attachment 71584 [details, diff]
General doc patch

i've just completely re-read pretty all documentation i could find, and my
conclusion is that we really don't need the technotes anymore. Beside removing
links and so on, I also made minor changes to the other docs. Doc devs please
review :)
Comment 6 Simon Stelling (RETIRED) gentoo-dev 2005-10-27 11:38:55 UTC
CC'ing them to get more attention ;)

/me is too impatient, I know, but this has been around for a pretty long period
Comment 7 Łukasz Damentko (RETIRED) gentoo-dev 2005-10-27 16:19:09 UTC
Please let us (docs-team) know before you delete them, we have to fix metadocs 
before or it will be another massive screw-up.
Comment 8 Luis Medinas (RETIRED) gentoo-dev 2005-10-30 11:56:32 UTC
Me and Gerald are working on it. We will ping docs teams about it before remove it.
Comment 9 Xavier Neys (RETIRED) gentoo-dev 2005-10-31 05:32:01 UTC
Links to technotes from /doc/en/* files have been removed
Comment 10 Xavier Neys (RETIRED) gentoo-dev 2005-10-31 05:36:06 UTC
Created attachment 71795 [details]
/proj/en/base/amd64/technotes/index.xml

You might want to replace the technotes index.xml with this one to avoid 404
errors and let users know where to go.
Comment 11 Gerald Normandin (RETIRED) 2005-11-02 16:32:35 UTC
Leaving existing technotes on proj, with a note regarding deprecation, so that
the old info can still be accessed while new section (Errata) and expansion of
howtos takes place.
Comment 12 Simon Stelling (RETIRED) gentoo-dev 2005-11-12 02:53:17 UTC
uhm, shouldn't we remove the link from proj/en/base/amd64/ to the technotes? i
can't see a good reason to leave it there at least ;)
Comment 13 Simon Stelling (RETIRED) gentoo-dev 2005-12-26 09:59:56 UTC
*** Bug 113917 has been marked as a duplicate of this bug. ***
Comment 14 Tom Martin (RETIRED) gentoo-dev 2006-01-15 14:16:58 UTC
Okay, I'm going to commit this all, but I'm going to post what's on my todo list here first; I'd appreciate it if someone could tell me I've missed anything or whatever.

1. Commit blubb's attachment #71584 [details, diff]
2. Commit something like neysx's attachment #71795 [details] -- I think I'll just add a note to the start of the technotes, but not get rid of any of the content.
Comment 15 Simon Stelling (RETIRED) gentoo-dev 2006-01-16 04:11:51 UTC
Tom, before you commit my patch, please let me have another look at it.. I just had a short look at it and found at least one typo (+	<p>We are continuouslylooking for volunteers willing to spend some of). As for the replacement, I agree, but there's already a fat "DEPRECATED" note on the top, so there's nothing to do :)
Comment 16 Simon Stelling (RETIRED) gentoo-dev 2006-01-16 12:30:32 UTC
Created attachment 77291 [details, diff]
removes technotes

as far as technotes are concerned, this should do it.
Comment 17 Simon Stelling (RETIRED) gentoo-dev 2006-04-29 11:34:18 UTC
technotes have been deprecated 6 months ago, all references to them were removed around that time too, except the one on our project page. removed that, together with the technotes themselves.