experimental.3 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147
  1. .TH "experimental" 3 "Sun Dec 27 2020" "openPilotLog" \" -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. experimental \- Temporary namespace for experimental features\&. Will be removed in later versions\&.
  6. .SH SYNOPSIS
  7. .br
  8. .PP
  9. .SS "Classes"
  10. .in +1c
  11. .ti -1c
  12. .RI "struct \fBAAircraftEntry\fP"
  13. .br
  14. .ti -1c
  15. .RI "class \fBADatabase\fP"
  16. .br
  17. .RI "The DB class encapsulates the SQL database by providing fast access to hot database data\&. "
  18. .ti -1c
  19. .RI "class \fBADatabaseError\fP"
  20. .br
  21. .RI "Custom Database Error derived from QSqlError\&. Extends text() adding 'Database Error: ' before the text\&. "
  22. .ti -1c
  23. .RI "class \fBAEntry\fP"
  24. .br
  25. .RI "The Entry class encapsulates table metadata(table name, row id) and data for new and existing entries in the database to operate on\&. "
  26. .ti -1c
  27. .RI "class \fBAFlightEntry\fP"
  28. .br
  29. .ti -1c
  30. .RI "struct \fBAPilotEntry\fP"
  31. .br
  32. .ti -1c
  33. .RI "struct \fBATailEntry\fP"
  34. .br
  35. .ti -1c
  36. .RI "struct \fBDataPosition\fP"
  37. .br
  38. .ti -1c
  39. .RI "class \fBUserInput\fP"
  40. .br
  41. .RI "The EntryData struct\&. Contains ALL possible data\&. However depending on who is constructing it, different types are initialised\&. FUTURE: Would it be necessary to able to change data? George: I would say no because we dont want to fuck around with the entry\&. Collect data from user -> Pack it up in the entry -> Consume it\&. "
  42. .in -1c
  43. .SS "Typedefs"
  44. .in +1c
  45. .ti -1c
  46. .RI "using \fBColName\fP = QString"
  47. .br
  48. .RI "An alias for QString\&. "
  49. .ti -1c
  50. .RI "using \fBColData\fP = QVariant"
  51. .br
  52. .ti -1c
  53. .RI "using \fBTableName\fP = QString"
  54. .br
  55. .ti -1c
  56. .RI "using \fBRowId\fP = int"
  57. .br
  58. .ti -1c
  59. .RI "using \fBTableNames\fP = QStringList"
  60. .br
  61. .ti -1c
  62. .RI "using \fBTableData\fP = QMap< \fBColName\fP, ColData >"
  63. .br
  64. .ti -1c
  65. .RI "using \fBColumnData\fP = QPair< \fBColName\fP, ColData >"
  66. .br
  67. .ti -1c
  68. .RI "using \fBColumnNames\fP = QStringList"
  69. .br
  70. .ti -1c
  71. .RI "using \fBTableColumns\fP = QMap< TableName, ColumnNames >"
  72. .br
  73. .ti -1c
  74. .RI "using \fBEntryData\fP = QMap< QString, QString >"
  75. .br
  76. .in -1c
  77. .SS "Enumerations"
  78. .in +1c
  79. .ti -1c
  80. .RI "enum \fBADatabaseTarget\fP { \fBairport_identifier_icao\fP, \fBairport_identifier_iata\fP, \fBairport_identifier_all\fP, \fBairport_names\fP, \fBpilots\fP, \fBregistrations\fP, \fBaircraft\fP, \fBcompanies\fP, \fBtails\fP }"
  81. .br
  82. .RI "The DBTarget enum provides the items for which QCompleter completion lists are provided from the database\&. "
  83. .in -1c
  84. .SS "Functions"
  85. .in +1c
  86. .ti -1c
  87. .RI "\fBADatabase\fP * \fBaDB\fP ()"
  88. .br
  89. .RI "Convinience function that returns instance of DataBase\&. Instead of this: DataBase::getInstance()\&.commit(\&.\&.\&.) Write this: \fBaDB()\fP->commit(\&.\&.\&.) "
  90. .ti -1c
  91. .RI "\fBUserInput\fP \fBnewPilotInput\fP (EntryData ed)"
  92. .br
  93. .ti -1c
  94. .RI "\fBUserInput\fP \fBnewFlightInput\fP (EntryData ed)"
  95. .br
  96. .ti -1c
  97. .RI "\fBUserInput\fP \fBnewAircraftInput\fP (EntryData ed)"
  98. .br
  99. .in -1c
  100. .SS "Variables"
  101. .in +1c
  102. .ti -1c
  103. .RI "auto const \fBDEFAULT_PILOT_POSITION\fP = \fBDataPosition\fP('pilots', 0)"
  104. .br
  105. .ti -1c
  106. .RI "auto const \fBDEFAULT_TAIL_POSITION\fP = \fBDataPosition\fP('tails', 0)"
  107. .br
  108. .ti -1c
  109. .RI "auto const \fBDEFAULT_AIRCRAFT_POSITION\fP = \fBDataPosition\fP('aircraft', 0)"
  110. .br
  111. .ti -1c
  112. .RI "auto const \fBDEFAULT_FLIGHT_POSITION\fP = \fBDataPosition\fP('flights', 0)"
  113. .br
  114. .in -1c
  115. .SH "Detailed Description"
  116. .PP
  117. Temporary namespace for experimental features\&. Will be removed in later versions\&.
  118. .PP
  119. \fBTodo\fP
  120. .RS 4
  121. Remove this namespace (and learn about some nice \\something of doxygen) Decide documentation style\&. https://www.doxygen.nl/manual/docblocks.html#specialblock
  122. .RE
  123. .PP
  124. .SH "Typedef Documentation"
  125. .PP
  126. .SS "using \fBexperimental::ColName\fP = typedef QString"
  127. .PP
  128. An alias for QString\&. Very long description \fIwith\fP \fBmarkdown?\fP
  129. .PP
  130. .PP
  131. .SH "Header"
  132. .PP
  133. .SH "Author"
  134. .PP
  135. Generated automatically by Doxygen for openPilotLog from the source code\&.