CやJavaなどのプログラム ソース中のコメントから,モジュール仕様書を書き出すツール。プログラムと文書を同時に管理できる。 コメントは記述形式が固定されており、そのとおりに従うと関数やデータ型、オブジェクトに関する定型的な文書が生成される。htmlやrtf, TeXのほかにmicrosoftのhtmlヘルプファイルなどを生成できる。
(狭い視点ですが)DoxygenでPythonを扱うのは無理です。 検討条件 windows10 python3.7 doxygen1.9.5(2022/11/03にインストール) 検討結果 対象のpythonコード import sys def tasu(aa,bb): c = aa + bb return c d = tasu(10,20) if d > 5: print("d",d) else: sys.exit() 結果 call graphとか、でましぇーん。 設定とか javaを選ぶのがいいというウワサに従い。。。 そもそも、Pythonが選べないのが、つらすぎる。。。。 コメント…
bool を返す constexpr function 互換性の関係で引数を省略できない 実装的には、引数は使用せず常に false を返す C++11 の constexpr function なので (void)param; を置いて回避する手は使えない Doxygen に怒られるので仮引数の型だけ残して仮引数をコメントアウトする手は使えない という条件でどうやって compiler, Doxygen, cppcheck の警告を完全回避できるんだ…と思ったんだが、 世の中には同じことを既に解決している人が既に居た。 stackoverflow.com constexpr bool isf…
Doxygenについては、以下の検索をたどってみてください。 Doxygen by Google Doxygen by Bing 本当にこのような高度なレベルのドキュメント生成機能を"GNU General Public Licence"で使わせて頂いていいのかと平身低頭になる強力な解析支援ツールであります。 既に多くの方が使い方、Tipsなどをアップされているので、今さら私がなにかをお伝えするよりも、検索した情報の方が有用ではないでしょうか。 ちなみにですが、Doxygenにお世話になる場合というのが、以下のシチュエーションが多いのが私の実情であります。 基本設計書、機能設計書までは、利用者…
はじめに バーンブレイバーン、アイうたじゃなくてボーボボ!! nikkieです Pythonの仮想環境、--upgrade-depsオプションを激推しするくらいヘビーユースしています。 私事で恐縮ですが、私nikkieは今般、仮想環境のお相手(=実体のディレクトリ)の名前を venv から .venv に変えたことを、読者の皆さまにご報告いたします。 ※本記事は小ネタです 目次 はじめに 目次 わたしと仮想環境 理由:公式ドキュメントに準拠したくて .venvに変えて嬉しい小さな点(macOS) 日本語のPython入門ドキュメントでは名はenv 終わりに わたしと仮想環境 ご報告のサマリ こ…
今日は chilled string 判定用の C API の追加や fork 時の割り込みの喪失の不具合修正などがありました。 [2b08406cd0] Étienne Barrié 2024-03-25 10:18:26 UTC 文字列オブジェクトが chilled string かどうか判定する C API rb_str_chilled_p() を追加しています。 [ruby-core:117302] [Bug #20389] [ruby-core:116382] [Feature #20205] [e9152bc9da] Andrew Konchin 2024-02-19 10:58:…
Creating a very simple SimObject https://www.gem5.org/documentation/learning_gem5/part2/helloobject/とりあえず書いてあるとおりに作業を進める。 バックアップしてスクラッチから書いていく。 $ git checkout -b hello-simobject $ mkdir -p backup/src/learning_gem5 $ mv src/learning_gem5/part2 backup/src/learning_gem5 $ mkdir -p backup/configs/learni…
今日は Module#ruby2_keywords をつけたメソッド内での super での呼び出しで引数を展開して渡したものの破壊的変更が行なわれる可能性のある不具合の修正や bundled gems の csv のバージョン更新などがありました。 [78e12beb6d] Nobuyoshi Nakada 2024-03-22 13:05:58 UTC YJIT の Rust コードをビルドするための rustc や cargo コマンドの実行する Makefile のコマンドの先頭に "+" をつけて make の jobserver のための fd を継承させるようにしています。 [7…
今日は主に標準添付ライブラリ reline の更新などがありました。 [e127289632] Earlopain 2024-03-19 12:49:05 UTC BasicObject の rdoc 用コメント内で respond_to_missing? メソッドの再定義におけるサンプルコードで BasicObject を親クラスとして持つクラスの respond_to_missing? で super を呼んでいたけど BasicObject には未定義なので削っています。 [ruby-core:116837] [Bug #20279] [d7bc6f0eff] tomoya ishida…
MacBook Air M2でPicoProbeをセットアップ MacBook Air M2でPicoProbeをセットアップ この記事でわかること コンパイル環境構築 PicoProbeの作成 OpenOCDのビルド 必要なツールをインストール ビルド OpenOCD実行 PicoProbeテスト PicoProbeと開発ターゲット用のPiPicoを結線 OpenOCD起動 実行ファイルの読込/実行 GDB起動 プログラムのロード プログラムの実行 プログラムの停止 Ctrl + c 操作で強制停止 デタッチ 終了 この記事でわかること Raspberry Picoの公式ドキュメントを参考に…
今日は主にデバッグ用の検証ビルド時チェック強化や Struct.new で定数を追加して remove_const で削除した時のメモリリークの修正などがありました。 [1a6a7c699c] Soutaro Matsumoto 2024-02-29 12:32:16 UTC gems/bundled_gems の rbs のテストに使う commit hash の指定を追加しています。 https://github.com/ruby/ruby/pull/10121 [d5bca0668c] Peter Zhu 2024-02-29 14:32:10 UTC finalizer の設定されてい…
今日は irb の debug 連係の機能追加やリファクタリング、YJIT のメソッド引数処理の強化などがありました。 [f012ce0d18] Max Prokopiev 2024-02-16 13:43:35 UTC prism の更新。 [c5f22b5b75] Peter Zhu 2024-02-15 21:09:57 UTC rb_ast_t からの参照を GC.compact で移動できるように rb_ast_update_references() で参照の更新に対応しています。 [f4f57e1162] Haldun Bayhantopcu 2024-02-15 20:24:21…
前回は、人間には読みにくいソースコードの説明を与えるのが、いわゆる「設計書」ではないかという考えを紹介した。 ただ、この考え方はまた別の問題を生み出してしまう。 腐る設計書? ソフトウェアは作って終わりというものではなく、作ったあともバグ修正や機能追加が入るのが普通だったりする。 そのとき、ソースコードを調査する必要が出てくるわけだけど、前述のとおり、ソースコードを読み解いていくのは大変。 そこで「そんなこともあろうかと」用意しておいた設計書を読むわけだけど、大抵はそこで絶望することになる。 なぜって、「設計書に書かれている内容と現状のソースコードが乖離している」ことがよくあるから。 ソースコ…
はじめに CS部のくつなりょうすけです。こんにちは。 GMailやYahoo!メールが1日5,000通以上のメールを送信してくる場合の制限が2024年2月1日から適用されるそうです。 DKIMやSPFなどでの対応を求められており、業界でも話題になっていることはご存じかと思います。 この記事は、その必須対応の中の、DKIMについて、Amazon Linux 2023でSMTPサーバ運用・メール送信している場合のopendkimパッケージ構築方法を示すものです。 AWSではEC2でメールサーバを構築していても、Amazon SESを使いDKIMを有効にすれば比較的容易に対応は可能です。 ここはあえ…
HTML_COPY_CLIPBOARDオプションを追加し、コードの断片をクリップボードにコピーできるようにした HTML出力に表示するアイコンを指定するためのオプションPROJECT_ICONの追加 HTML_PROJECT_COOKIEオプションを追加し、異なるプロジェクトで異なるクッキーを使用できるようにした PROJECT_LOGOにオプションでwidth=とheight=を指定できるようにした doxyappにJSON出力を追加 より柔軟な継承グラフの表示/非表示 より柔軟なインラインソースの表示/非表示 ポルトガル語翻訳を1.10.0に更新 doxmlparserをPyPIに公開 あ…
今日は 3.3.0 のリリースがされました。また master ブランチは 3.4.0 の開発が開始され、同期が停止されていた標準添付ライブラリの upstream からのマージがたくさんありました。また it の導入もありました。https://www.ruby-lang.org/ja/news/2023/12/25/ruby-3-3-0-released/ [37753f163e] Samuel Williams 2023-12-24 13:03:36 UTC IO::Buffer.map のフラグに IO::Buffer::PRIVATE のビットが立ってた時の Windows 環境での…
gihyo.jp 良いコード/悪いコードで学ぶ設計入門 の読書メモです。 長いので章ごとにしてます。 11 コメント ー保守と変更の正確性を高める書き方ー コメントはなるべく書かないようにしてます。読んでわからないようなことを書かないようにしてるつもりで…。 TODO、FIXMEとかそういうのがほとんど…のはずです。 11.1 退化コメント コメントはテストされないですからねぇ…。 11.1.1 コメントは劣化コピーに過ぎないことを理解すること ああ、意志そのものじゃないからですか…。なるほどです。 11.1.2 ロジックの挙動をなぞるだけのコメントは退化しやすい 流し読みしようとしたときに読…
今日は主に rubygems と bundler の更新や M:N Thread の不具合修正、compaction 対応の修正、(nil..nil) の挙動の変更などがありました。 [e191bf42d2] Peter Zhu 2023-12-19 01:55:59 UTC 配列オブジェクトの部分配列を作る実装で compaction によるバッファの移動(slot に埋め込んでる場合)がありうるのに追随していなかったため異常終了する可能性があった不具合を修正しています。 [1710eb9367] John Hawthorn 2023-12-20 18:37:02 UTC NEWS やドキュ…
今日は WeakMap/WeakKeyMap の compaction 時の不具合修正、添字つき演算子つき代入メソッド+キーワード引数のメソッド呼び出しの不具合修正、標準添付ライブラリのバージョン更新などなどたくさんの変更がありました。 [d1c25605f6] Martin Emde 2023-12-11 23:31:15 UTC bundler で Gemfile の ruby version の指定を .ruby-version ファイルから読ませる指定の時の .ruby-version ファイルを Gemfile と同じディレクトリのものを使うようにしています。 [25b9a0cbc8…