/usr/lib/python2.7/dist-packages/dolfin_utils/documentation/docstringutils.py is in python-dolfin 2016.2.0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 | # -*- coding: utf-8 -*-
"Utility functions for docstring manipulations."
# Copyright (C) 2010 Anders Logg
#
# This file is part of DOLFIN.
#
# DOLFIN is free software: you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# DOLFIN is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with DOLFIN. If not, see <http://www.gnu.org/licenses/>.
#
# Modified by Kristian B. Oelgaard, 2010.
# Modified by Marie E. Rognes, 2011.
#
# First added: 2010-08-26
# Last changed: 2011-05-10
import re
_compiled_cache = {}
def indent(string, num_spaces):
"Indent given text block given number of spaces"
return "\n".join(num_spaces*" " + l for l in string.split("\n"))
def add_links(text, classnames, link_type):
"Add crosslinks for classes"
for classname in classnames:
if classname not in text:
continue
p = _compiled_cache.get(classname)
if not p:
p = re.compile(r"\b_%s_\b" % classname)
_compiled_cache[classname] = p
text = p.sub("%s`%s`" % (link_type, classname), text)
# Escape pointer arguments: replace * by \* after class names
text = text.replace("`*", "`\*")
return text
|