Skip to content
GitLab
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • openfoam openfoam
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 413
    • Issues 413
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 7
    • Merge requests 7
  • Deployments
    • Deployments
    • Releases
  • Wiki
    • Wiki
  • Activity
  • Graph
  • Create a new issue
  • Commits
  • Issue Boards
Collapse sidebar
  • Development
  • openfoamopenfoam
  • Merge requests
  • !348

DOC: Elaborate the usage of function objects

  • Review changes

  • Download
  • Email patches
  • Plain diff
Merged Kutalmış Berçin requested to merge doc-FOs-part-1 into develop Mar 13, 2020
  • Overview 8
  • Commits 1
  • Changes 264

Summary

Documentation and usage examples are limited for some of the function objects. This somewhat hampers the efforts of users to access all capabilities of them.

Therefore, we decided to elaborate the usage of function objectcs in:

  • Extended Code Guide (comprises the full spectrum of details)
  • Header files (comprises the minimal set of info, directing the users to the central info hub, the Extended Code Guide)

In parallel to the Extended Code Guide improvements (corresponding: Extended Code Guide:doc-FOs-part-1), it is useful:

  • to provide a minimal documentation in the header files of the function objects
  • to provide at least one example of usage per function object in tutorials

In addition, style/implementation consistency across function objects can be imposed for:

  • update libs of etc/caseDicts/postProcess items
  • ensure destructor=default
  • ensure no copy construct/no copy assignment
  • static data members
  • ensure constness
  • change lookupOrDefault() to getOrDefault()

Resolved bugs

#1594 (closed)

Risks

Considerably low.

Regression tests are pending.

Edited Apr 24, 2020 by Kutalmış Berçin
Assignee
Assign to
Reviewers
Request review from
Time tracking
Source branch: doc-FOs-part-1