Edgewall Software

Opened 10 years ago

Closed 10 years ago

Last modified 7 years ago

#11429 closed enhancement (fixed)

Add documentation for ExtraPermissionsProvider on the component admin page — at Version 3

Reported by: Ryan J Ollos Owned by: Ryan J Ollos
Priority: normal Milestone: 1.0.2
Component: general Version:
Severity: normal Keywords: permissions ExtraPermissionsProvider documentation
Cc: Branch:
Release Notes:

ExtraPermissionsProvider: Added a link to the documentation on the TracIni page from the Component description on the plugin admin page.

API Changes:
Internal Changes:

Description

The ExtraPermissionsProvider is documented on t.e.o, but there is no documentation provided with the distribution other than the snippet here: TracPermissions#CreatingNewPrivileges. There, it is stated For more information, please refer to the documentation of the component in the admin panel. However, there is no documentation of the component in the admin panel, so the proposal is to add documentation.

Change History (3)

comment:1 by Ryan J Ollos, 10 years ago

Status: newassigned

It seems there is documentation for ExtraPermissionsProvider, but while it is visible on the admin panel in 0.12.6dev, it is not visible in 1.0.2dev.

comment:2 by Ryan J Ollos, 10 years ago

Keywords: permissions ExtraPermissionsProvider documentation added; permission ExteraPermissionsProvider removed
Milestone: 0.12.61.0.2

Okay, I see now. TracPermissions#CreatingNewPrivileges has been edited. I propose a simple patch to help users navigate to the documentation:

  • tracopt/perm/config_perm_provider.py

    diff --git a/tracopt/perm/config_perm_provider.py b/tracopt/perm/config_perm_pro
    index 2dfec53..cf2b7fa 100644
    a b  
    11# -*- coding: utf-8 -*-
    22#
    3 # Copyright (C) 2009 Edgewall Software
     3# Copyright (C) 2009-2013 Edgewall Software
    44# All rights reserved.
    55#
    66# This software is licensed as described in the file COPYING, which
    from trac.perm import IPermissionRequestor  
    1717
    1818
    1919class ExtraPermissionsProvider(Component):
    20     """Extra permission provider."""
     20    """Define arbitrary permissions.
     21
     22    Documentation can be found on the [wiki:TracIni#extra-permissions-section]
     23    page after enabling the component."""
    2124
    2225    implements(IPermissionRequestor)

comment:3 by Ryan J Ollos, 10 years ago

Release Notes: modified (diff)
Resolution: fixed
Status: assignedclosed

Committed to 1.0-stable in [12416] and merged to trunk in [12417].

Note: See TracTickets for help on using tickets.