Commit 34ae1828 authored by Peter Eisentraut's avatar Peter Eisentraut

doc: Make function synopsis formatting more uniform

Whitespace use was inconsistent in the same chapter.
parent 1c53f612
...@@ -101,7 +101,7 @@ ...@@ -101,7 +101,7 @@
<para> <para>
<programlisting> <programlisting>
void void
GetForeignRelSize (PlannerInfo *root, GetForeignRelSize(PlannerInfo *root,
RelOptInfo *baserel, RelOptInfo *baserel,
Oid foreigntableid); Oid foreigntableid);
</programlisting> </programlisting>
...@@ -132,7 +132,7 @@ GetForeignRelSize (PlannerInfo *root, ...@@ -132,7 +132,7 @@ GetForeignRelSize (PlannerInfo *root,
<para> <para>
<programlisting> <programlisting>
void void
GetForeignPaths (PlannerInfo *root, GetForeignPaths(PlannerInfo *root,
RelOptInfo *baserel, RelOptInfo *baserel,
Oid foreigntableid); Oid foreigntableid);
</programlisting> </programlisting>
...@@ -163,7 +163,7 @@ GetForeignPaths (PlannerInfo *root, ...@@ -163,7 +163,7 @@ GetForeignPaths (PlannerInfo *root,
<para> <para>
<programlisting> <programlisting>
ForeignScan * ForeignScan *
GetForeignPlan (PlannerInfo *root, GetForeignPlan(PlannerInfo *root,
RelOptInfo *baserel, RelOptInfo *baserel,
Oid foreigntableid, Oid foreigntableid,
ForeignPath *best_path, ForeignPath *best_path,
...@@ -199,7 +199,7 @@ GetForeignPlan (PlannerInfo *root, ...@@ -199,7 +199,7 @@ GetForeignPlan (PlannerInfo *root,
<para> <para>
<programlisting> <programlisting>
void void
BeginForeignScan (ForeignScanState *node, BeginForeignScan(ForeignScanState *node,
int eflags); int eflags);
</programlisting> </programlisting>
...@@ -227,7 +227,7 @@ BeginForeignScan (ForeignScanState *node, ...@@ -227,7 +227,7 @@ BeginForeignScan (ForeignScanState *node,
<para> <para>
<programlisting> <programlisting>
TupleTableSlot * TupleTableSlot *
IterateForeignScan (ForeignScanState *node); IterateForeignScan(ForeignScanState *node);
</programlisting> </programlisting>
Fetch one row from the foreign source, returning it in a tuple table slot Fetch one row from the foreign source, returning it in a tuple table slot
...@@ -264,7 +264,7 @@ IterateForeignScan (ForeignScanState *node); ...@@ -264,7 +264,7 @@ IterateForeignScan (ForeignScanState *node);
<para> <para>
<programlisting> <programlisting>
void void
ReScanForeignScan (ForeignScanState *node); ReScanForeignScan(ForeignScanState *node);
</programlisting> </programlisting>
Restart the scan from the beginning. Note that any parameters the Restart the scan from the beginning. Note that any parameters the
...@@ -275,7 +275,7 @@ ReScanForeignScan (ForeignScanState *node); ...@@ -275,7 +275,7 @@ ReScanForeignScan (ForeignScanState *node);
<para> <para>
<programlisting> <programlisting>
void void
EndForeignScan (ForeignScanState *node); EndForeignScan(ForeignScanState *node);
</programlisting> </programlisting>
End the scan and release resources. It is normally not important End the scan and release resources. It is normally not important
...@@ -297,7 +297,7 @@ EndForeignScan (ForeignScanState *node); ...@@ -297,7 +297,7 @@ EndForeignScan (ForeignScanState *node);
<para> <para>
<programlisting> <programlisting>
void void
GetForeignJoinPaths (PlannerInfo *root, GetForeignJoinPaths(PlannerInfo *root,
RelOptInfo *joinrel, RelOptInfo *joinrel,
RelOptInfo *outerrel, RelOptInfo *outerrel,
RelOptInfo *innerrel, RelOptInfo *innerrel,
...@@ -356,7 +356,7 @@ GetForeignJoinPaths (PlannerInfo *root, ...@@ -356,7 +356,7 @@ GetForeignJoinPaths (PlannerInfo *root,
<para> <para>
<programlisting> <programlisting>
void void
GetForeignUpperPaths (PlannerInfo *root, GetForeignUpperPaths(PlannerInfo *root,
UpperRelationKind stage, UpperRelationKind stage,
RelOptInfo *input_rel, RelOptInfo *input_rel,
RelOptInfo *output_rel); RelOptInfo *output_rel);
...@@ -404,7 +404,7 @@ GetForeignUpperPaths (PlannerInfo *root, ...@@ -404,7 +404,7 @@ GetForeignUpperPaths (PlannerInfo *root,
<para> <para>
<programlisting> <programlisting>
void void
AddForeignUpdateTargets (Query *parsetree, AddForeignUpdateTargets(Query *parsetree,
RangeTblEntry *target_rte, RangeTblEntry *target_rte,
Relation target_relation); Relation target_relation);
</programlisting> </programlisting>
...@@ -451,7 +451,7 @@ AddForeignUpdateTargets (Query *parsetree, ...@@ -451,7 +451,7 @@ AddForeignUpdateTargets (Query *parsetree,
<para> <para>
<programlisting> <programlisting>
List * List *
PlanForeignModify (PlannerInfo *root, PlanForeignModify(PlannerInfo *root,
ModifyTable *plan, ModifyTable *plan,
Index resultRelation, Index resultRelation,
int subplan_index); int subplan_index);
...@@ -490,7 +490,7 @@ PlanForeignModify (PlannerInfo *root, ...@@ -490,7 +490,7 @@ PlanForeignModify (PlannerInfo *root,
<para> <para>
<programlisting> <programlisting>
void void
BeginForeignModify (ModifyTableState *mtstate, BeginForeignModify(ModifyTableState *mtstate,
ResultRelInfo *rinfo, ResultRelInfo *rinfo,
List *fdw_private, List *fdw_private,
int subplan_index, int subplan_index,
...@@ -536,7 +536,7 @@ BeginForeignModify (ModifyTableState *mtstate, ...@@ -536,7 +536,7 @@ BeginForeignModify (ModifyTableState *mtstate,
<para> <para>
<programlisting> <programlisting>
TupleTableSlot * TupleTableSlot *
ExecForeignInsert (EState *estate, ExecForeignInsert(EState *estate,
ResultRelInfo *rinfo, ResultRelInfo *rinfo,
TupleTableSlot *slot, TupleTableSlot *slot,
TupleTableSlot *planSlot); TupleTableSlot *planSlot);
...@@ -582,7 +582,7 @@ ExecForeignInsert (EState *estate, ...@@ -582,7 +582,7 @@ ExecForeignInsert (EState *estate,
<para> <para>
<programlisting> <programlisting>
TupleTableSlot * TupleTableSlot *
ExecForeignUpdate (EState *estate, ExecForeignUpdate(EState *estate,
ResultRelInfo *rinfo, ResultRelInfo *rinfo,
TupleTableSlot *slot, TupleTableSlot *slot,
TupleTableSlot *planSlot); TupleTableSlot *planSlot);
...@@ -628,7 +628,7 @@ ExecForeignUpdate (EState *estate, ...@@ -628,7 +628,7 @@ ExecForeignUpdate (EState *estate,
<para> <para>
<programlisting> <programlisting>
TupleTableSlot * TupleTableSlot *
ExecForeignDelete (EState *estate, ExecForeignDelete(EState *estate,
ResultRelInfo *rinfo, ResultRelInfo *rinfo,
TupleTableSlot *slot, TupleTableSlot *slot,
TupleTableSlot *planSlot); TupleTableSlot *planSlot);
...@@ -672,7 +672,7 @@ ExecForeignDelete (EState *estate, ...@@ -672,7 +672,7 @@ ExecForeignDelete (EState *estate,
<para> <para>
<programlisting> <programlisting>
void void
EndForeignModify (EState *estate, EndForeignModify(EState *estate,
ResultRelInfo *rinfo); ResultRelInfo *rinfo);
</programlisting> </programlisting>
...@@ -689,7 +689,7 @@ EndForeignModify (EState *estate, ...@@ -689,7 +689,7 @@ EndForeignModify (EState *estate,
<para> <para>
<programlisting> <programlisting>
int int
IsForeignRelUpdatable (Relation rel); IsForeignRelUpdatable(Relation rel);
</programlisting> </programlisting>
Report which update operations the specified foreign table supports. Report which update operations the specified foreign table supports.
...@@ -729,7 +729,7 @@ IsForeignRelUpdatable (Relation rel); ...@@ -729,7 +729,7 @@ IsForeignRelUpdatable (Relation rel);
<para> <para>
<programlisting> <programlisting>
bool bool
PlanDirectModify (PlannerInfo *root, PlanDirectModify(PlannerInfo *root,
ModifyTable *plan, ModifyTable *plan,
Index resultRelation, Index resultRelation,
int subplan_index); int subplan_index);
...@@ -771,7 +771,7 @@ PlanDirectModify (PlannerInfo *root, ...@@ -771,7 +771,7 @@ PlanDirectModify (PlannerInfo *root,
<para> <para>
<programlisting> <programlisting>
void void
BeginDirectModify (ForeignScanState *node, BeginDirectModify(ForeignScanState *node,
int eflags); int eflags);
</programlisting> </programlisting>
...@@ -805,7 +805,7 @@ BeginDirectModify (ForeignScanState *node, ...@@ -805,7 +805,7 @@ BeginDirectModify (ForeignScanState *node,
<para> <para>
<programlisting> <programlisting>
TupleTableSlot * TupleTableSlot *
IterateDirectModify (ForeignScanState *node); IterateDirectModify(ForeignScanState *node);
</programlisting> </programlisting>
When the <command>INSERT</>, <command>UPDATE</> or <command>DELETE</> When the <command>INSERT</>, <command>UPDATE</> or <command>DELETE</>
...@@ -851,7 +851,7 @@ IterateDirectModify (ForeignScanState *node); ...@@ -851,7 +851,7 @@ IterateDirectModify (ForeignScanState *node);
<para> <para>
<programlisting> <programlisting>
void void
EndDirectModify (ForeignScanState *node); EndDirectModify(ForeignScanState *node);
</programlisting> </programlisting>
Clean up following a direct modification on the remote server. It is Clean up following a direct modification on the remote server. It is
...@@ -879,7 +879,7 @@ EndDirectModify (ForeignScanState *node); ...@@ -879,7 +879,7 @@ EndDirectModify (ForeignScanState *node);
<para> <para>
<programlisting> <programlisting>
RowMarkType RowMarkType
GetForeignRowMarkType (RangeTblEntry *rte, GetForeignRowMarkType(RangeTblEntry *rte,
LockClauseStrength strength); LockClauseStrength strength);
</programlisting> </programlisting>
...@@ -911,7 +911,7 @@ GetForeignRowMarkType (RangeTblEntry *rte, ...@@ -911,7 +911,7 @@ GetForeignRowMarkType (RangeTblEntry *rte,
<para> <para>
<programlisting> <programlisting>
HeapTuple HeapTuple
RefetchForeignRow (EState *estate, RefetchForeignRow(EState *estate,
ExecRowMark *erm, ExecRowMark *erm,
Datum rowid, Datum rowid,
bool *updated); bool *updated);
...@@ -970,7 +970,8 @@ RefetchForeignRow (EState *estate, ...@@ -970,7 +970,8 @@ RefetchForeignRow (EState *estate,
<para> <para>
<programlisting> <programlisting>
bool bool
RecheckForeignScan (ForeignScanState *node, TupleTableSlot *slot); RecheckForeignScan(ForeignScanState *node,
TupleTableSlot *slot);
</programlisting> </programlisting>
Recheck that a previously-returned tuple still matches the relevant Recheck that a previously-returned tuple still matches the relevant
scan and join qualifiers, and possibly provide a modified version of scan and join qualifiers, and possibly provide a modified version of
...@@ -1011,7 +1012,7 @@ RecheckForeignScan (ForeignScanState *node, TupleTableSlot *slot); ...@@ -1011,7 +1012,7 @@ RecheckForeignScan (ForeignScanState *node, TupleTableSlot *slot);
<para> <para>
<programlisting> <programlisting>
void void
ExplainForeignScan (ForeignScanState *node, ExplainForeignScan(ForeignScanState *node,
ExplainState *es); ExplainState *es);
</programlisting> </programlisting>
...@@ -1033,7 +1034,7 @@ ExplainForeignScan (ForeignScanState *node, ...@@ -1033,7 +1034,7 @@ ExplainForeignScan (ForeignScanState *node,
<para> <para>
<programlisting> <programlisting>
void void
ExplainForeignModify (ModifyTableState *mtstate, ExplainForeignModify(ModifyTableState *mtstate,
ResultRelInfo *rinfo, ResultRelInfo *rinfo,
List *fdw_private, List *fdw_private,
int subplan_index, int subplan_index,
...@@ -1059,7 +1060,7 @@ ExplainForeignModify (ModifyTableState *mtstate, ...@@ -1059,7 +1060,7 @@ ExplainForeignModify (ModifyTableState *mtstate,
<para> <para>
<programlisting> <programlisting>
void void
ExplainDirectModify (ForeignScanState *node, ExplainDirectModify(ForeignScanState *node,
ExplainState *es); ExplainState *es);
</programlisting> </programlisting>
...@@ -1087,7 +1088,7 @@ ExplainDirectModify (ForeignScanState *node, ...@@ -1087,7 +1088,7 @@ ExplainDirectModify (ForeignScanState *node,
<para> <para>
<programlisting> <programlisting>
bool bool
AnalyzeForeignTable (Relation relation, AnalyzeForeignTable(Relation relation,
AcquireSampleRowsFunc *func, AcquireSampleRowsFunc *func,
BlockNumber *totalpages); BlockNumber *totalpages);
</programlisting> </programlisting>
...@@ -1109,8 +1110,10 @@ AnalyzeForeignTable (Relation relation, ...@@ -1109,8 +1110,10 @@ AnalyzeForeignTable (Relation relation,
If provided, the sample collection function must have the signature If provided, the sample collection function must have the signature
<programlisting> <programlisting>
int int
AcquireSampleRowsFunc (Relation relation, int elevel, AcquireSampleRowsFunc(Relation relation,
HeapTuple *rows, int targrows, int elevel,
HeapTuple *rows,
int targrows,
double *totalrows, double *totalrows,
double *totaldeadrows); double *totaldeadrows);
</programlisting> </programlisting>
...@@ -1132,7 +1135,7 @@ AcquireSampleRowsFunc (Relation relation, int elevel, ...@@ -1132,7 +1135,7 @@ AcquireSampleRowsFunc (Relation relation, int elevel,
<para> <para>
<programlisting> <programlisting>
List * List *
ImportForeignSchema (ImportForeignSchemaStmt *stmt, Oid serverOid); ImportForeignSchema(ImportForeignSchemaStmt *stmt, Oid serverOid);
</programlisting> </programlisting>
Obtain a list of foreign table creation commands. This function is Obtain a list of foreign table creation commands. This function is
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment