This file is indexed.

/usr/share/octave/packages/geometry-1.7.0/geom2d/geom2d_Contents.m is in octave-geometry 1.7.0-1build1.

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
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
## Copyright (C) 2004-2011 David Legland <david.legland@grignon.inra.fr>
## Copyright (C) 2004-2011 INRA - CEPIA Nantes - MIAJ (Jouy-en-Josas)
## Copyright (C) 2012 Adapted to Octave by Juan Pablo Carbajal <carbajal@ifi.uzh.ch>
## All rights reserved.
## 
## Redistribution and use in source and binary forms, with or without
## modification, are permitted provided that the following conditions are met:
## 
##     1 Redistributions of source code must retain the above copyright notice,
##       this list of conditions and the following disclaimer.
##     2 Redistributions in binary form must reproduce the above copyright
##       notice, this list of conditions and the following disclaimer in the
##       documentation and/or other materials provided with the distribution.
## 
## THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ''AS IS''
## AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
## IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
## ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
## ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
## DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
## SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
## CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
## OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
## OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

## -*- texinfo -*-
## @deftypefn {Function File} geom2d_Contents ()
## Geometry 2D Toolbox
## Version 1.2.0 21-Oct-2011 .
##
## 	Library to handle and visualize geometric primitives such as points,
## 	lines, circles and ellipses, polygons...
##
##   The goal is to provide a low-level library for manipulating geometrical
##   primitives, making easier the development of more complex geometric
##   algorithms.
##
##   Most functions works for planar shapes, but some ones have been
##   extended to 3D or to any dimension.
##
## Points
##   points2d             - Description of functions operating on points
##   clipPoints           - Clip a set of points by a box
##   centroid             - Compute centroid (center of mass) of a set of points
##   midPoint             - Middle point of two points or of an edge
##   isCounterClockwise   - Compute relative orientation of 3 points
##   polarPoint           - Create a point from polar coordinates (rho + theta)
##   angle2Points         - Compute horizontal angle between 2 points
##   angle3Points         - Compute oriented angle made by 3 points
##   angleSort            - Sort points in the plane according to their angle to origin
##   distancePoints       - Compute distance between two points
##   minDistancePoints    - Minimal distance between several points
##   transformPoint       - Transform a point with an affine transform
##   drawPoint            - Draw the point on the axis.
##
## Vectors
##   vectors2d            - Description of functions operating on plane vectors
##   createVector         - Create a vector from two points
##   vectorNorm           - Compute norm of a vector, or of a set of vectors
##   vectorAngle          - Angle of a vector, or between 2 vectors
##   normalizeVector      - Normalize a vector to have norm equal to 1
##   isPerpendicular      - Check orthogonality of two vectors
##   isParallel           - Check parallelism of two vectors
##   transformVector      - Transform a vector with an affine transform
##   rotateVector         - Rotate a vector by a given angle
##
## Straight lines
##   lines2d              - Description of functions operating on planar lines
##   createLine           - Create a straight line from 2 points, or from other inputs
##   medianLine           - Create a median line between two points
##   cartesianLine        - Create a straight line from cartesian equation coefficients
##   orthogonalLine       - Create a line orthogonal to another one.
##   parallelLine         - Create a line parallel to another one.
##   intersectLines       - Return all intersection points of N lines in 2D
##   lineAngle            - Computes angle between two straight lines
##   linePosition         - Position of a point on a line
##   lineFit              - Fit a straight line to a set of points
##   clipLine             - Clip a line with a box
##   reverseLine          - Return same line but with opposite orientation
##   transformLine        - Transform a line with an affine transform
##   drawLine             - Draw the line on the current axis
##
## Edges (line segments between 2 points)
##   edges2d              - Description of functions operating on planar edges
##   createEdge           - Create an edge between two points, or from a line
##   edgeToLine           - Convert an edge to a straight line
##   edgeAngle            - Return angle of edge
##   edgeLength           - Return length of an edge
##   midPoint             - Middle point of two points or of an edge
##   edgePosition         - Return position of a point on an edge
##   clipEdge             - Clip an edge with a rectangular box
##   reverseEdge          - Intervert the source and target vertices of edge
##   intersectEdges       - Return all intersections between two set of edges
##   intersectLineEdge    - Return intersection between a line and an edge
##   transformEdge        - Transform an edge with an affine transform
##   drawEdge             - Draw an edge given by 2 points
##   drawCenteredEdge     - Draw an edge centered on a point
##
## Rays
##   rays2d               - Description of functions operating on planar rays
##   createRay            - Create a ray (half-line), from various inputs
##   bisector             - Return the bisector of two lines, or 3 points
##   clipRay              - Clip a ray with a box
##   drawRay              - Draw a ray on the current axis
##
## Relations between points and lines
##   distancePointEdge    - Minimum distance between a point and an edge
##   distancePointLine    - Minimum distance between a point and a line
##   projPointOnLine      - Project of a point orthogonally onto a line
##   pointOnLine          - Create a point on a line at a given position on the line
##   isPointOnLine        - Test if a point belongs to a line
##   isPointOnEdge        - Test if a point belongs to an edge
##   isPointOnRay         - Test if a point belongs to a ray
##   isLeftOriented       - Test if a point is on the left side of a line
##
## Circles
##   circles2d            - Description of functions operating on circles
##   createCircle         - Create a circle from 2 or 3 points
##   createDirectedCircle - Create a directed circle
##   intersectCircles     - Intersection points of two circles
##   intersectLineCircle  - Intersection point(s) of a line and a circle
##   circleAsPolygon      - Convert a circle into a series of points
##   circleArcAsCurve     - Convert a circle arc into a series of points
##   isPointInCircle      - Test if a point is located inside a given circle
##   isPointOnCircle      - Test if a point is located on a given circle.
##   enclosingCircle      - Find the minimum circle enclosing a set of points.
##   radicalAxis          - Compute the radical axis (or radical line) of 2 circles
##   drawCircle           - Draw a circle on the current axis
##   drawCircleArc        - Draw a circle arc on the current axis
##
## Ellipses
##   ellipses2d           - Description of functions operating on ellipses
##   inertiaEllipse       - Inertia ellipse of a set of points
##   isPointInEllipse     - Check if a point is located inside a given ellipse
##   ellipseAsPolygon     - Convert an ellipse into a series of points
##   drawEllipse          - Draw an ellipse on the current axis
##   drawEllipseArc       - Draw an ellipse arc on the current axis
##
## Geometric transforms
##   transforms2d         - Description of functions operating on transforms
##   createTranslation    - Create the 3*3 matrix of a translation
##   createRotation       - Create the 3*3 matrix of a rotation
##   createScaling        - Create the 3*3 matrix of a scaling in 2 dimensions
##   createHomothecy      - Create the the 3x3 matrix of an homothetic transform
##   createBasisTransform - Compute matrix for transforming a basis into another basis
##   createLineReflection - Create the the 3x3 matrix of a line reflection
##   fitAffineTransform2d - Fit an affine transform using two point sets
##
## Angles
##   angles2d             - Description of functions for manipulating angles
##   normalizeAngle       - Normalize an angle value within a 2*PI interval
##   angleAbsDiff         - Absolute difference between two angles
##   angleDiff            - Difference between two angles
##   deg2rad              - Convert angle from degrees to radians
##   rad2deg              - Convert angle from radians to degrees
##
## Boxes
##   boxes2d              - Description of functions operating on bounding boxes
##   intersectBoxes       - Intersection of two bounding boxes
##   mergeBoxes           - Merge two boxes, by computing their greatest extent
##   randomPointInBox     - Generate random point within a box
##   drawBox              - Draw a box defined by coordinate extents
##
## Various drawing functions
##   drawBezierCurve      - Draw a cubic bezier curve defined by 4 control points
##   drawParabola         - Draw a parabola on the current axis
##   drawOrientedBox      - Draw centered oriented rectangle
##   drawRect             - Draw rectangle on the current axis
##   drawArrow            - Draw an arrow on the current axis
##   drawLabels           - Draw labels at specified positions
##   drawShape            - Draw various types of shapes (circles, polygons...)
##
## Other shapes
##   squareGrid           - Generate equally spaces points in plane.
##   hexagonalGrid        - Generate hexagonal grid of points in the plane.
##   triangleGrid         - Generate triangular grid of points in the plane.
##   crackPattern         - Create a (bounded) crack pattern tessellation
##   crackPattern2        - Create a (bounded) crack pattern tessellation
##
##
##   Credits:
##   * function 'enclosingCircle' rewritten from a file from Yazan Ahed
##    , available on Matlab File Exchange
##
## @end deftypefn

function geom2d_Contents ()

  help('geom2d_Contents');

  ##   Deprecated functions

  #   createMedian         - create a median line
  #   minDistance          - compute minimum distance between a point and a set of points
  #   homothecy            - create a homothecy as an affine transform
  #   rotation             - return 3*3 matrix of a rotation
  #   translation          - return 3*3 matrix of a translation
  #   scaling              - return 3*3 matrix of a scaling in 2 dimensions
  #   lineSymmetry         - create line symmetry as 2D affine transform
  #   vecnorm              - compute norm of vector or of set of vectors
  #   normalize            - normalize a vector
  #   onCircle             - test if a point is located on a given circle.
  #   inCircle             - test if a point is located inside a given circle.
  #   onEdge               - test if a point belongs to an edge
  #   onLine               - test if a point belongs to a line
  #   onRay                - test if a point belongs to a ray
  #   invertLine           - return same line but with opposite orientation
  #   clipLineRect         - clip a line with a polygon
  #   formatAngle          - Ensure an angle value is comprised between 0 and 2*PI


  ## Others...
  #   drawRect2            - Draw centered rectangle on the current axis

endfunction