[Bug 10967] New: include/asm-i386 removed but not documented

[Bug 10967] New: include/asm-i386 removed but not documented

[bugme-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

http://bugzilla.kernel.org/show_bug.cgi?id=10967

           Summary: include/asm-i386 removed but not documented
           Product: Documentation
           Version: unspecified
     KernelVersion: 2.6.24+
          Platform: All
        OS/Version: Linux
              Tree: Mainline
            Status: NEW
          Severity: normal
          Priority: P1
         Component: man-pages
        AssignedTo: documentation_man-pages-ztI5WcYan/vQLgFONoPN62D2FQJk+8+b@public.gmane.org
        ReportedBy: osgnuru-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org


Latest working kernel version:2.6.25.8
Earliest failing kernel version:2.6.24
Distribution:N/A
Hardware Environment:i386
Software Environment:N/A
Problem Description:Between kernel 2.6.23.17 and 2.6.24 the include/asm-i386
directory was removed and there is no mention of it in the change log or the
documentation. A new directory include/asm-x86 was added, one might assume this
to be the replacement but still this also is not documented. There are still
many source files that include headers from asm-i386 and also third party
software that will try to include /usr/include/asm-i386 will now be broken for
anyone trying to compile a kernel on a 32 bit CPU.

Documentation should include recommendations for changes needed to compile on a
Linux system that has this alteration.


-- 
Configure bugmail: http://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 10967] include/asm-i386 removed but not documented

[bugme-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

http://bugzilla.kernel.org/show_bug.cgi?id=10967


devzero-S0/GAf8tV78@public.gmane.org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |devzero-S0/GAf8tV78@public.gmane.org




------- Comment #1 from devzero-S0/GAf8tV78@public.gmane.org  2008-06-23 11:54 -------
>Problem Description:Between kernel 2.6.23.17 and 2.6.24 the include/asm-i386
>directory was removed

it`s because of i386/x64 unification. see http://lwn.net/Articles/243704/

>there is no mention of it in the change log or the documentation.

it`s all documented - it began here
http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=commit;h=96a388de5dc53a8b234b3fd41f3ae2cedc9ffd42

and this is the latest information about those changes in asm-i386
http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=history;f=include/asm-x86;h=9999ac87466fcbe63aa527c61f1e11627a349dea;hb=481c5346d0981940ee63037eb53e4e37b0735c10

git provides more detail than any documentation can provide. it`s the whole
changelog for the kernel - patch by patch.

>There are still many source files that include headers from asm-i386 

which ?

>and also third party software that will try to include /usr/include/asm-i386 >will now be broken for anyone trying to compile a kernel on a 32 bit CPU.

yes, we know out of tree code is a pain in the ass - but it`s like that - and
that`s the way it is. 
see
http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob;f=Documentation/stable_api_nonsense.txt


-- 
Configure bugmail: http://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 10967] include/asm-i386 removed but not documented

[bugme-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

http://bugzilla.kernel.org/show_bug.cgi?id=10967





------- Comment #2 from osgnuru-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org  2008-06-23 12:18 -------
Would have been nice to see a one liner about this change in the change log.

Not trying to be a jerk. I know trying to document everything can be a big job.

Two thumbs up for all the kernel developers and the work they are doing.
Thanks.


-- 
Configure bugmail: http://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 10967] include/asm-i386 removed but not documented

[bugme-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

http://bugzilla.kernel.org/show_bug.cgi?id=10967


devzero-S0/GAf8tV78@public.gmane.org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
         AssignedTo|documentation_man-          |devzero-S0/GAf8tV78@public.gmane.org
                   |pages-ztI5WcYan/vQLgFONoPN62D2FQJk+8+b@public.gmane.org  |
             Status|NEW                         |ASSIGNED




-- 
Configure bugmail: http://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
You are the assignee for the bug, or are watching the assignee.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html