개발자언어(주석달기 위한 영어)

주석은 주로 한글로 달지만(한글로 달아도 나중에는 뭔 소리인지 모를때가 있기 때문에) 외국쪽에 소스를 오픈해야 할때에는 영어 주석이 필수이다.
따라서, 구구절절 달지는 못해도 주로 간단하게 사용할만한 표현만 정리해 보았다.
주로 st 마이크로프로세서에서 제공하는 소스주석을 보고 공부하였다.

▷ 입력버퍼에 관한 pBuffer포인터 : pBuffer pointer to the input data buffer
▷ char타입을 가진 입력버퍼 포인터 : input buffer pointer with char type.
▷ 실제 타이머는 인트럽트 루틴에서 구현된다 :
  → actual timer is implemented in the interrupt routine.
이전 타이머 : the previous timer value.
▷ 이전 타이머 값과 새로 들어온 타이머값을 조합하여 ㅇㅇㅇ
  → ㅇㅇㅇ using combination of the previous timer value and the new one
▷ 전송할 바이트 수 가져오기(전송을 위해서 구성된 바이트 수)
  → Get the number of bytes configured for transfer
▷ 변수를 설명할 때 자주 사용하는 표현
  function(char aaa)
  aaa : this parameter
▷ START비트가 1일때, 이 비트들을 변경하면 안된다.(변경하는 것이 허락되지 않음)
  → Changing these bits when START bit is set is not allowed
▷ data length와 data size : 주로 2개를 혼용해서 사용하는 것 같다.
  원문주석 코드를 보면
  → length : 주로 16비트 데이터 길이와 같이 비트가 들어갈때 자주 사용.
     물론 데이터 길이에서도 length도 사용하였기에 조금 더 볼 필요가 있다.
  → size : 우리가 말하는 전체 데이터 사이즈를 말할때.
   예) SPI data size, DMA Memory data size,
▷ 전체 버퍼 길이 : Total Buffer Length 또는 the total length of the buffer
▷ 전체 버퍼을 읽어라 : Read the whole buffer.
▷ 남아 있는 바이트 수(어떤 연산이나 조작을 하고 남아 있는 바이트) :
  → the number of remaining bytes.
▷ 출력버퍼에 맞는(맞춘) 최대 메세지 크기 :
  → the maximum message size that fits in the output buffer.
▷ flag에 1로 셋팅 : set flag to 1.
▷ A에서 출력 버퍼로 복사 : copy A into the output buffer.
▷ 수신 데이터 : the received data.
▷ 장치로 부터 데이터를 읽는 방법은 : The way data is read out of the device is ~~
▷ 읽을 레지스터를 지정하는 것 : specifying which register is to be read
▷ 의 63%를 달성하는데 걸리는 시간 : Time for achieving 63% of ~
▷ 데이터 배열 data_pau8에 복사할 바이트수 : Number of bytes which are copied to data array data_pau8.



댓글 없음:

댓글 쓰기

인지편항대도감1

 NEWTON 24년 3월호에 나온 특집기사를 요약해 본다. 인지편향은 마음의 안정과 신속한 판단을 가지는 장점과 함께 잘못된 판단 및 편견으로 이끄는  요인이기도 하다.  한번쯤은 이런 편향에 빠지지 않았는지를 자신을 돌아볼 필요가 있다. 1) 부정...