- Remove duplicate doc-comments for struct members - Add missing @member markers for in-line member comments
Showing the changes to include/uapi (1 of 1 file). Show all
Unified · Split
| @@ -905,24 +905,23 @@ struct drm_format_modifier { · 904 unmodified lines | ||
| 905 | 905 | |
| 906 | 906 | /** |
| 907 | 907 | * struct drm_mode_create_blob - Create New block property |
| 908 | − * @data: Pointer to data to copy. | |
| 909 | − * @length: Length of data to copy. | |
| 910 | − * @blob_id: new property ID. | |
| 908 | + * | |
| 911 | 909 | * Create a new 'blob' data property, copying length bytes from data pointer, |
| 912 | 910 | * and returning new blob ID. |
| 913 | 911 | */ |
| 914 | 912 | struct drm_mode_create_blob { |
| 915 | − /** Pointer to data to copy. */ | |
| 913 | + /** @data: Pointer to data to copy. */ | |
| 916 | 914 | __u64 data; |
| 917 | − /** Length of data to copy. */ | |
| 915 | + /** @length: Length of data to copy. */ | |
| 918 | 916 | __u32 length; |
| 919 | − /** Return: new property ID. */ | |
| 917 | + /** @blob_id: Return: new property ID. */ | |
| 920 | 918 | __u32 blob_id; |
| 921 | 919 | }; |
| 922 | 920 | |
| 923 | 921 | /** |
| 924 | 922 | * struct drm_mode_destroy_blob - Destroy user blob |
| 925 | 923 | * @blob_id: blob_id to destroy |
| 924 | + * | |
| 926 | 925 | * Destroy a user-created blob property. |
| 927 | 926 | * |
| 928 | 927 | * User-space can release blobs as soon as they do not need to refer to them by |
| @@ -937,36 +936,32 @@ struct drm_mode_destroy_blob { · 8 unmodified lines | ||
| 937 | 936 | |
| 938 | 937 | /** |
| 939 | 938 | * struct drm_mode_create_lease - Create lease |
| 940 | − * @object_ids: Pointer to array of object ids. | |
| 941 | − * @object_count: Number of object ids. | |
| 942 | − * @flags: flags for new FD. | |
| 943 | − * @lessee_id: unique identifier for lessee. | |
| 944 | − * @fd: file descriptor to new drm_master file. | |
| 939 | + * | |
| 945 | 940 | * Lease mode resources, creating another drm_master. |
| 946 | 941 | */ |
| 947 | 942 | struct drm_mode_create_lease { |
| 948 | − /** Pointer to array of object ids (__u32) */ | |
| 943 | + /** @object_ids: Pointer to array of object ids (__u32) */ | |
| 949 | 944 | __u64 object_ids; |
| 950 | − /** Number of object ids */ | |
| 945 | + /** @object_count: Number of object ids */ | |
| 951 | 946 | __u32 object_count; |
| 952 | − /** flags for new FD (O_CLOEXEC, etc) */ | |
| 947 | + /** @flags: flags for new FD (O_CLOEXEC, etc) */ | |
| 953 | 948 | __u32 flags; |
| 954 | 949 | |
| 955 | − /** Return: unique identifier for lessee. */ | |
| 950 | + /** @lessee_id: Return: unique identifier for lessee. */ | |
| 956 | 951 | __u32 lessee_id; |
| 957 | − /** Return: file descriptor to new drm_master file */ | |
| 952 | + /** @fd: Return: file descriptor to new drm_master file */ | |
| 958 | 953 | __u32 fd; |
| 959 | 954 | }; |
| 960 | 955 | |
| 961 | 956 | /** |
| 962 | 957 | * struct drm_mode_list_lessees - List lessees |
| 963 | − * @count_lessees: Number of lessees. | |
| 964 | − * @pad: pad. | |
| 965 | − * @lessees_ptr: Pointer to lessess. | |
| 966 | − * List lesses from a drm_master | |
| 958 | + * | |
| 959 | + * List lesses from a drm_master. | |
| 967 | 960 | */ |
| 968 | 961 | struct drm_mode_list_lessees { |
| 969 | − /** Number of lessees. | |
| 962 | + /** | |
| 963 | + * @count_lessees: Number of lessees. | |
| 964 | + * | |
| 970 | 965 | * On input, provides length of the array. |
| 971 | 966 | * On output, provides total number. No |
| 972 | 967 | * more than the input number will be written |
| @@ -974,23 +969,26 @@ struct drm_mode_list_lessees { · 1 unmodified line | ||
| 974 | 969 | * the size and then the data. |
| 975 | 970 | */ |
| 976 | 971 | __u32 count_lessees; |
| 972 | + /** @pad: Padding. */ | |
| 977 | 973 | __u32 pad; |
| 978 | 974 | |
| 979 | − /** Pointer to lessees. | |
| 980 | − * pointer to __u64 array of lessee ids | |
| 975 | + /** | |
| 976 | + * @lessees_ptr: Pointer to lessees. | |
| 977 | + * | |
| 978 | + * Pointer to __u64 array of lessee ids | |
| 981 | 979 | */ |
| 982 | 980 | __u64 lessees_ptr; |
| 983 | 981 | }; |
| 984 | 982 | |
| 985 | 983 | /** |
| 986 | 984 | * struct drm_mode_get_lease - Get Lease |
| 987 | − * @count_objects: Number of leased objects. | |
| 988 | − * @pad: pad. | |
| 989 | − * @objects_ptr: Pointer to objects. | |
| 990 | − * Get leased objects | |
| 985 | + * | |
| 986 | + * Get leased objects. | |
| 991 | 987 | */ |
| 992 | 988 | struct drm_mode_get_lease { |
| 993 | − /** Number of leased objects. | |
| 989 | + /** | |
| 990 | + * @count_objects: Number of leased objects. | |
| 991 | + * | |
| 994 | 992 | * On input, provides length of the array. |
| 995 | 993 | * On output, provides total number. No |
| 996 | 994 | * more than the input number will be written |
| @@ -998,22 +996,22 @@ struct drm_mode_get_lease { · 1 unmodified line | ||
| 998 | 996 | * the size and then the data. |
| 999 | 997 | */ |
| 1000 | 998 | __u32 count_objects; |
| 999 | + /** @pad: Padding. */ | |
| 1001 | 1000 | __u32 pad; |
| 1002 | 1001 | |
| 1003 | − /** Pointer to objects. | |
| 1004 | − * pointer to __u32 array of object ids | |
| 1002 | + /** | |
| 1003 | + * @objects_ptr: Pointer to objects. | |
| 1004 | + * | |
| 1005 | + * Pointer to __u32 array of object ids. | |
| 1005 | 1006 | */ |
| 1006 | 1007 | __u64 objects_ptr; |
| 1007 | 1008 | }; |
| 1008 | 1009 | |
| 1009 | 1010 | /** |
| 1010 | 1011 | * struct drm_mode_revoke_lease - Revoke lease |
| 1011 | − * @lessee_id: Unique ID of lessee. | |
| 1012 | − * Revoke lease | |
| 1013 | 1012 | */ |
| 1014 | 1013 | struct drm_mode_revoke_lease { |
| 1015 | − /** Unique ID of lessee | |
| 1016 | − */ | |
| 1014 | + /** @lessee_id: Unique ID of lessee */ | |
| 1017 | 1015 | __u32 lessee_id; |
| 1018 | 1016 | }; |
| 1019 | 1017 | |