From cf07fb13368d87d0bfb582bdc613c1546d55cbb5 Mon Sep 17 00:00:00 2001 From: Martin Mares Date: Sat, 4 Oct 2008 21:57:12 +0200 Subject: [PATCH] More help fixes. --- help/newitem | 62 +++++++++++++++++++++++++++++++------------------- help/pci | 20 ++++++++++------ help/pci_class | 2 +- 3 files changed, 53 insertions(+), 31 deletions(-) diff --git a/help/newitem b/help/newitem index 5024b92..4308893 100644 --- a/help/newitem +++ b/help/newitem @@ -1,24 +1,46 @@ -Add a new item +Adding a new item +

+If you know about an ID which is not listed in the database, you are welcome +to submit a new entry. +

+To add it, browse to its parent entry, click on the add item link +and enter the last part of the new ID (without the parent ID) together with its name. +For example, when you want to submit the PCI device 1234:5678 (vendor ID 1234, +device ID 5678) and the vendor 1234 already exists, go to the page of +that vendor and enter a new item with ID 5678 there.

-If you know about an ID which is not listed in the database, you will be welcome -to submit it. -Just browse to the parent item and click on the add item link. If you want to change an existing entry, just post a discussion item instead.

-To create a new entry, you need to fill in the ID and its name. -The ID is just the last part (without the parent part; for example if you have PCI device -1234:5678 and the vendor 1234 already exists, you enter only 5678). -If you know chip name, it is preferred over marketing name. +You can also add a note to the name. The notes are distributed together with the ID's, +so they should be used only in important cases (for example to draw attention to the fact +that the ID was used by a different company due to a mistake).

-You can add some note to the name, for example, if the ID is not really owned by the company using it. -You can add a discussion comment to it (why you think it is correct). -The difference between note and discussion is that note is additional information to name, while discussion is administrative. -Also, note is sometimes distributed, while discussion isn't. +If you want to comment on anything, feel free to post a discussion comment. (Unlike +the note, it is only kept for other people editing the lists, not distributed to +users.)

-Both note and discussion is optional. -

-After you submit it, it will wait approval of an admin. +After you submit the change, it will wait for approval by an admin. + +

Rules

+

+There is a couple of simple rules you should obey: +

+

If you are not familar with the syntax of the ID's, please check the description: +

Approval

@@ -26,12 +48,6 @@ All submissions are checked by the administrators for errors. The admins either the entry, or ask you to correct it or to provide more details. In cases of blatant abuse (spam in comments etc.), they have the power to remove the entry completely.

-Before submitting changes, please consult the -You should check specific help for corresponding ID type: -

Notification subscription

@@ -40,6 +56,6 @@ For more information about notifications look at discuss existing items and suggest them new names. +Once an item is submitted, it is not sealed for ever. You can discuss existing items and suggest new names for them.

-If you are interested in changes in some item (or its whole subtree), you can let the system send you notifications. +If you are interested in changes in some item (or in its whole subtree), you can let the system send you notifications. diff --git a/help/pci b/help/pci index 214b462..eb18b7b 100644 --- a/help/pci +++ b/help/pci @@ -1,19 +1,25 @@ PCI devices

Vendors

-The top level of hierarchy is a vendor list. -Each vendor has a 2-byte long id, stored in database as 4 hexadecimal digits (with lowercase letters). +The top level of the hierarchy is the list of vendors. +Each vendor has a 2-byte ID, stored in the database as 4 hexadecimal digits (with lowercase letters). They can be browsed here.

Devices

-Each vendor contains a list of its devices. -Each device in the list has a 2-byte long id, stored the same way as vendor id (4 hexadecimal letters). +Each vendor keeps a list of his devices and assigns ID's to them. +Each device in the list has a 2-byte long ID, stored the same way as the vendor ID (4 hexadecimal digits).

Subsystems

-A device can consist of more sub-systems. -Each sub-system has 4-byte long id, stored as 8 hexadecimal letters, split in the middle by a space (for example 1234 abcd could be a sub-system id). -The first quad of digits is considered a vendor id (from the same list of vendors). The vendor of the sub-system can be different than vendor of the device. +

+Sometimes, a device ID is not sufficient to select the right driver. For example, the same +chip can be wired in different ways on different boards. In such cases, the manufacturer of +the board defines a subsystem ID for the board, which serves as an additional identification. +

+The subsystem ID's are 4 bytes long, stored as 8 hexadecimal letters with a space in the middle +(e.g., 1234 abcd could be a subsystem ID). +The first quad of digits is the vendor ID (from the same list of vendors as the devices; +possibly different from the vendor of the device itself), the rest is assigned by the vendor.

See also

diff --git a/help/pci_class b/help/pci_class index 427932d..acf18eb 100644 --- a/help/pci_class +++ b/help/pci_class @@ -1,4 +1,4 @@ -PCI device classes +PCI Device Classes

Device classes

Device class is identified by a single byte. It is stored as 2 hexadecimal digits (all in lowercase). -- 2.39.2